@fnndsc/brasa 0.9.1 → 0.10.0

package/dist/buildinfo.json

@@ -0,0 +1 @@
+{"hash":"858de5"}

package/dist/builtins/argumentTokens.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file Shared token-preserving parsing for executable options.
+ *
+ * Plugin execution, PACS attachment, and pipeline bindings use this module so
+ * quoted values and scalar coercion remain identical across command surfaces.
+ *
+ * @module
+ */
+/** Parsed executable option names and their scalar values. */
+export type ExecutableArguments = Record<string, string | boolean | number>;
+/**
+ * Parse already-tokenized options and context assignments.
+ *
+ * @param tokens - `--name value`, `--name=value`, or bare `name=value` tokens.
+ * @returns Dictionary containing scalar-coerced option values.
+ * @throws {Error} When a token is not an option or assignment.
+ */
+export declare function executableArguments_parse(tokens: readonly string[]): ExecutableArguments;

package/dist/builtins/argumentTokens.js

@@ -0,0 +1,58 @@
+/**
+ * @file Shared token-preserving parsing for executable options.
+ *
+ * Plugin execution, PACS attachment, and pipeline bindings use this module so
+ * quoted values and scalar coercion remain identical across command surfaces.
+ *
+ * @module
+ */
+function argumentValue_parse(value) {
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value.trim() !== '') {
+        const numeric = Number(value);
+        if (!Number.isNaN(numeric))
+            return numeric;
+    }
+    return value;
+}
+/**
+ * Parse already-tokenized options and context assignments.
+ *
+ * @param tokens - `--name value`, `--name=value`, or bare `name=value` tokens.
+ * @returns Dictionary containing scalar-coerced option values.
+ * @throws {Error} When a token is not an option or assignment.
+ */
+export function executableArguments_parse(tokens) {
+    const result = {};
+    for (let index = 0; index < tokens.length; index++) {
+        const token = tokens[index];
+        const prefixed = token.startsWith('-') && token !== '-';
+        const bareAssignment = !prefixed && token.indexOf('=') > 0;
+        if (!prefixed && !bareAssignment)
+            throw new Error(`Unexpected value without an option: ${token}`);
+        const option = prefixed ? token.replace(/^-+/, '') : token;
+        const equalsIndex = option.indexOf('=');
+        if (equalsIndex >= 0) {
+            const name = option.slice(0, equalsIndex);
+            if (!name)
+                throw new Error(`Invalid option: ${token}`);
+            result[name] = argumentValue_parse(option.slice(equalsIndex + 1));
+            continue;
+        }
+        if (!option)
+            throw new Error(`Invalid option: ${token}`);
+        const next = tokens[index + 1];
+        if (next !== undefined && (!next.startsWith('-') || /^-\d/.test(next))) {
+            result[option] = argumentValue_parse(next);
+            index++;
+        }
+        else {
+            result[option] = true;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=argumentTokens.js.map

package/dist/builtins/argumentTokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"argumentTokens.js","sourceRoot":"","sources":["../../src/builtins/argumentTokens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,OAAO,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAyB;IACjE,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,IAAI,KAAK,GAAW,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAY,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,GAAG,CAAC;QACjE,MAAM,cAAc,GAAY,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;QAClG,MAAM,MAAM,GAAW,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnE,MAAM,WAAW,GAAW,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;YACvD,MAAM,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC;YAClE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;QACzD,MAAM,IAAI,GAAuB,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACnD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC3C,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/builtins/executable.d.ts

@@ -3,9 +3,7 @@
  *
  * @module
  */
-type PluginExecutableOptions = {
-    piped?: boolean;
-};
+import { type CommandEnvelope } from '@fnndsc/cumin';
 /**
  * Handles simulated execution of plugins (e.g., "pl-simpledsapp-v1.2.3 --parameters").
  *
@@ -15,8 +13,6 @@ type PluginExecutableOptions = {
  *
  * @param command - The command string (potentially a plugin name).
  * @param args - The arguments passed to the command.
- * @param options - Optional flags for piped/non-interactive handling.
- * @returns A Promise resolving to true if the command was handled as a plugin execution, false otherwise.
+ * @returns An envelope when the command was handled, or null otherwise.
  */
-export declare function pluginExecutable_handle(command: string, args: string[], options?: PluginExecutableOptions): Promise<boolean>;
-export {};
+export declare function pluginExecutable_handle(command: string, args: string[]): Promise<CommandEnvelope | null>;

package/dist/builtins/executable.js

@@ -8,6 +8,8 @@ import { spinner } from '../lib/spinner.js';
 import { builtin_parametersofplugin } from './parametersofplugin.js';
 import { plugins_list, plugins_listAll } from '@fnndsc/salsa';
 import { pluginReadme_fetch, pluginReadme_render } from '@fnndsc/chili/commands/plugin/readme.js';
+import { errorStack, envelope_ok } from '@fnndsc/cumin';
+import { pluginExecutableHelp_render } from './help.js';
 /**
  * Handles simulated execution of plugins (e.g., "pl-simpledsapp-v1.2.3 --parameters").
  *
@@ -17,28 +19,22 @@ import { pluginReadme_fetch, pluginReadme_render } from '@fnndsc/chili/commands/
  *
  * @param command - The command string (potentially a plugin name).
  * @param args - The arguments passed to the command.
- * @param options - Optional flags for piped/non-interactive handling.
- * @returns A Promise resolving to true if the command was handled as a plugin execution, false otherwise.
+ * @returns An envelope when the command was handled, or null otherwise.
  */
-export async function pluginExecutable_handle(command, args, options) {
+export async function pluginExecutable_handle(command, args) {
     // Expected format: name-vVersion (e.g., "pl-simpledsapp-v2.1.3")
     const versionSeparatorIndex = command.lastIndexOf('-v');
     if (versionSeparatorIndex === -1) {
-        return false;
+        return null;
     }
     const name = command.substring(0, versionSeparatorIndex);
     const version = command.substring(versionSeparatorIndex + 2);
     if (!name || !version) {
-        return false;
+        return null;
     }
     const showHelp = args.includes('--help') || args.includes('-h');
-    const isPipedOutput = !!options?.piped || !process.stdout.isTTY;
     if (showHelp) {
-        console.log(chalk.cyan(`Plugin executable flags for ${name}-v${version}:`));
-        console.log('  --parameters   Show parameter definitions for this plugin version');
-        console.log('  --readme       Show README (rendered) from plugin metadata repository URL');
-        console.log('  --readme --raw Output raw markdown, suitable for piping to glow or bat');
-        return true;
+        return envelope_ok(pluginExecutableHelp_render(command));
     }
     const plugin_resolveExact = async () => {
         try {
@@ -66,50 +62,57 @@ export async function pluginExecutable_handle(command, args, options) {
             return { id: candidate.id, name: candidate.name, version: candidate.version };
         }
         catch (error) {
-            console.error(chalk.red(`Error resolving plugin: ${error instanceof Error ? error.message : String(error)}`));
+            errorStack.stack_push('error', `Error resolving plugin: ${error instanceof Error ? error.message : String(error)}`);
             return null;
         }
     };
     if (args.includes('--readme')) {
         const rawMode = args.includes('--raw');
-        console.log(chalk.cyan(`Resolving plugin ${name} v${version} for README...`));
+        let rendered = rawMode
+            ? ''
+            : `${chalk.cyan(`Resolving plugin ${name} v${version} for README...`)}\n`;
         const resolved = await plugin_resolveExact();
         if (!resolved) {
-            console.log(chalk.red(`Plugin ${name} v${version} not found.`));
-            return true;
+            rendered += `${chalk.red(`Plugin ${name} v${version} not found.`)}\n`;
+            return envelope_ok(rendered);
         }
         spinner.start(`Fetching README for ${resolved.name} v${resolved.version}...`);
         try {
-            const content = await pluginReadme_fetch(String(resolved.id));
+            const document = await pluginReadme_fetch(String(resolved.id));
             spinner.stop();
-            if (content) {
-                console.log(rawMode ? content : pluginReadme_render(content));
+            if (document) {
+                if (rawMode)
+                    return envelope_ok(document.content);
+                const readme = pluginReadme_render(document);
+                rendered += readme.endsWith('\n') ? readme : `${readme}\n`;
             }
             else {
-                console.log(chalk.yellow(`No README found for ${resolved.name} v${resolved.version}.`));
+                rendered += `${chalk.yellow(`No README found for ${resolved.name} v${resolved.version}.`)}\n`;
             }
         }
         catch (error) {
             spinner.stop();
             const message = error instanceof Error ? error.message : String(error);
-            console.log(chalk.red(`Failed to fetch README: ${message}`));
+            rendered += `${chalk.red(`Failed to fetch README: ${message}`)}\n`;
         }
-        return true;
+        return envelope_ok(rendered);
     }
     if (args.includes('--parameters')) {
-        console.log(chalk.cyan(`Fetching parameters for plugin ${name} v${version}...`));
+        let rendered = `${chalk.cyan(`Fetching parameters for plugin ${name} v${version}...`)}\n`;
         const resolved = await plugin_resolveExact();
         if (!resolved) {
-            console.log(chalk.red(`Plugin ${name} v${version} not found.`));
-            return true; // Handled (attempted), but failed
+            rendered += `${chalk.red(`Plugin ${name} v${version} not found.`)}\n`;
+            return envelope_ok(rendered);
         }
-        console.log(chalk.cyan(`Resolved Plugin: ${resolved.name} v${resolved.version} (ID: ${resolved.id})`));
+        rendered += `${chalk.cyan(`Resolved Plugin: ${resolved.name} v${resolved.version} (ID: ${resolved.id})`)}\n`;
         // Delegate to parametersofplugin builtin with the resolved context
-        await builtin_parametersofplugin(['list', '--plugin-id', String(resolved.id)]);
-        return true;
+        const parametersEnvelope = await builtin_parametersofplugin([
+            'list', '--plugin-id', String(resolved.id),
+        ]);
+        return { ...parametersEnvelope, rendered: rendered + parametersEnvelope.rendered };
     }
     // If command matches plugin format but no handled flags are present,
-    // return false to let the main loop handle it (or show unknown command).
-    return false;
+    // return null to let the main loop handle it (or show unknown command).
+    return null;
 }
 //# sourceMappingURL=executable.js.map

package/dist/builtins/executable.js.map

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

package/dist/builtins/feedCreation.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @file Shared bookkeeping for newly created feeds.
+ * @module
+ */
+/** Optional child scheduled immediately below the pl-dircopy root. */
+export interface NewFeedChild {
+    id: number;
+    pluginName: string;
+}
+/** Data needed to expose a newly created feed through `/proc` immediately. */
+export interface NewFeedCacheEntry {
+    feedID: number;
+    title: string;
+    ownerUsername: string;
+    rootInstanceID: number;
+    child?: NewFeedChild;
+}
+/**
+ * Adds a new feed, its pl-dircopy root, and an optional child to ProcCache.
+ *
+ * @param entry - Stable feed/root identities plus optional scheduled child.
+ */
+export declare function newFeed_cacheAdd(entry: NewFeedCacheEntry): void;

package/dist/builtins/feedCreation.js

@@ -0,0 +1,45 @@
+/**
+ * @file Shared bookkeeping for newly created feeds.
+ * @module
+ */
+import { procCache_get } from '@fnndsc/cumin';
+/**
+ * Adds a new feed, its pl-dircopy root, and an optional child to ProcCache.
+ *
+ * @param entry - Stable feed/root identities plus optional scheduled child.
+ */
+export function newFeed_cacheAdd(entry) {
+    const scheduledJobs = entry.child ? 2 : 1;
+    procCache_get().feed_add({
+        id: entry.feedID,
+        title: entry.title,
+        ownerUsername: entry.ownerUsername,
+        public: false,
+        creationDate: new Date().toISOString(),
+        finishedJobs: 0,
+        erroredJobs: 0,
+        startedJobs: 0,
+        scheduledJobs,
+        cancelledJobs: 0,
+        createdJobs: 0,
+    });
+    procCache_get().instance_add({
+        id: entry.rootInstanceID,
+        feedID: entry.feedID,
+        parentID: null,
+        pluginName: 'pl-dircopy',
+        params: null,
+        status: 'scheduled',
+    });
+    if (entry.child) {
+        procCache_get().instance_add({
+            id: entry.child.id,
+            feedID: entry.feedID,
+            parentID: entry.rootInstanceID,
+            pluginName: entry.child.pluginName,
+            params: null,
+            status: 'scheduled',
+        });
+    }
+}
+//# sourceMappingURL=feedCreation.js.map

package/dist/builtins/feedCreation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedCreation.js","sourceRoot":"","sources":["../../src/builtins/feedCreation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAiB9C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,MAAM,aAAa,GAAW,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,aAAa,EAAE,CAAC,QAAQ,CAAC;QACvB,EAAE,EAAE,KAAK,CAAC,MAAM;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,KAAK;QACb,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,CAAC;QACd,aAAa;QACb,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,CAAC;KACf,CAAC,CAAC;IACH,aAAa,EAAE,CAAC,YAAY,CAAC;QAC3B,EAAE,EAAE,KAAK,CAAC,cAAc;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,YAAY;QACxB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,WAAW;KACpB,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC,YAAY,CAAC;YAC3B,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,cAAc;YAC9B,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU;YAClC,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,WAAW;SACpB,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/builtins/fs/cat.args.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @file Shared `cat` command-line grammar.
+ *
+ * Defines the typed result used by the builtin, the usage text shown in help
+ * and errors, and the option predicate used by redirect filename inference.
+ * This module is intentionally dependency-free so preprocessing can consume
+ * the grammar without loading the file reader or syntax highlighter.
+ *
+ * @module
+ */
+/** Whether syntax highlighting follows TTY detection, is forced, or is disabled. */
+export type CatHighlightMode = 'auto' | 'always' | 'never';
+/** Parsed `cat` command-line arguments. */
+export interface CatArguments {
+    binaryMode: boolean;
+    highlightMode: CatHighlightMode;
+    highlightLanguage?: string;
+    filePaths: string[];
+}
+/** Canonical usage shared by builtin errors and interactive help. */
+export declare const CAT_USAGE: string;
+/**
+ * Returns whether an argument belongs to the `cat` option grammar.
+ *
+ * @param argument - One token from the command line.
+ * @returns True for a recognized binary or highlight option.
+ */
+export declare function catArgument_isOption(argument: string): boolean;
+/**
+ * Parses file paths and presentation options for the `cat` builtin.
+ * Later highlight flags take precedence over earlier highlight flags.
+ *
+ * @param args - Tokens following the `cat` command name.
+ * @returns Typed binary, highlighting, language, and file-path selections.
+ */
+export declare function catArguments_parse(args: string[]): CatArguments;

package/dist/builtins/fs/cat.args.js

@@ -0,0 +1,63 @@
+/**
+ * @file Shared `cat` command-line grammar.
+ *
+ * Defines the typed result used by the builtin, the usage text shown in help
+ * and errors, and the option predicate used by redirect filename inference.
+ * This module is intentionally dependency-free so preprocessing can consume
+ * the grammar without loading the file reader or syntax highlighter.
+ *
+ * @module
+ */
+/** Canonical usage shared by builtin errors and interactive help. */
+export const CAT_USAGE = 'cat [--binary] [--highlight[=language] | --no-highlight] <file> [file...]';
+const BINARY_OPTION = '--binary';
+const HIGHLIGHT_OPTION = '--highlight';
+const HIGHLIGHT_LANGUAGE_PREFIX = '--highlight=';
+const NO_HIGHLIGHT_OPTION = '--no-highlight';
+/**
+ * Returns whether an argument belongs to the `cat` option grammar.
+ *
+ * @param argument - One token from the command line.
+ * @returns True for a recognized binary or highlight option.
+ */
+export function catArgument_isOption(argument) {
+    return argument === BINARY_OPTION
+        || argument === HIGHLIGHT_OPTION
+        || argument === NO_HIGHLIGHT_OPTION
+        || argument.startsWith(HIGHLIGHT_LANGUAGE_PREFIX);
+}
+/**
+ * Parses file paths and presentation options for the `cat` builtin.
+ * Later highlight flags take precedence over earlier highlight flags.
+ *
+ * @param args - Tokens following the `cat` command name.
+ * @returns Typed binary, highlighting, language, and file-path selections.
+ */
+export function catArguments_parse(args) {
+    let binaryMode = false;
+    let highlightMode = 'auto';
+    let highlightLanguage;
+    const filePaths = [];
+    for (const argument of args) {
+        if (argument === BINARY_OPTION) {
+            binaryMode = true;
+        }
+        else if (argument === HIGHLIGHT_OPTION) {
+            highlightMode = 'always';
+            highlightLanguage = undefined;
+        }
+        else if (argument.startsWith(HIGHLIGHT_LANGUAGE_PREFIX)) {
+            highlightMode = 'always';
+            highlightLanguage = argument.slice(HIGHLIGHT_LANGUAGE_PREFIX.length);
+        }
+        else if (argument === NO_HIGHLIGHT_OPTION) {
+            highlightMode = 'never';
+            highlightLanguage = undefined;
+        }
+        else {
+            filePaths.push(argument);
+        }
+    }
+    return { binaryMode, highlightMode, highlightLanguage, filePaths };
+}
+//# sourceMappingURL=cat.args.js.map

package/dist/builtins/fs/cat.args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cat.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/cat.args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,qEAAqE;AACrE,MAAM,CAAC,MAAM,SAAS,GACpB,2EAA2E,CAAC;AAE9E,MAAM,aAAa,GAAW,UAAU,CAAC;AACzC,MAAM,gBAAgB,GAAW,aAAa,CAAC;AAC/C,MAAM,yBAAyB,GAAW,cAAc,CAAC;AACzD,MAAM,mBAAmB,GAAW,gBAAgB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,QAAQ,KAAK,aAAa;WAC5B,QAAQ,KAAK,gBAAgB;WAC7B,QAAQ,KAAK,mBAAmB;WAChC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,IAAI,UAAU,GAAY,KAAK,CAAC;IAChC,IAAI,aAAa,GAAqB,MAAM,CAAC;IAC7C,IAAI,iBAAqC,CAAC;IAC1C,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC/B,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,QAAQ,KAAK,gBAAgB,EAAE,CAAC;YACzC,aAAa,GAAG,QAAQ,CAAC;YACzB,iBAAiB,GAAG,SAAS,CAAC;QAChC,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,CAAC;YAC1D,aAAa,GAAG,QAAQ,CAAC;YACzB,iBAAiB,GAAG,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QACvE,CAAC;aAAM,IAAI,QAAQ,KAAK,mBAAmB,EAAE,CAAC;YAC5C,aAAa,GAAG,OAAO,CAAC;YACxB,iBAAiB,GAAG,SAAS,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC"}

package/dist/builtins/fs/cat.d.ts

@@ -3,13 +3,13 @@ import type { CommandEnvelope } from '@fnndsc/cumin';
  * Displays the content of one or more files.
  *
  * Supports multiple files and concatenates their output. Binary mode is applied
- * consistently to all files if any file is detected as binary or --binary is specified.
+ * per recognized file, or consistently to all files when `--binary` is specified.
  * Text content and errors are buffered into the envelope; binary content streams
  * to the terminal directly with backpressure (raw bytes are not envelope text),
  * and the binary auto-detection notice is emitted live on the err channel so it
  * precedes the bytes it describes.
  *
- * @param args - Command line arguments (file paths and optional --binary flag).
+ * @param args - File paths plus optional binary/highlight flags.
  * @returns An envelope whose rendered text carries the (highlighted) file
  *   contents and whose model lists per-file outcomes.
  */