@fnndsc/chili 3.4.0 → 3.6.0

package/dist/handlers/baseGroupHandler.js

@@ -9,12 +9,13 @@ import { options_toParams } from "../utils/cli.js";
 import { resourceColumns_removeDuplicates } from "../utils/resourceData.js";
 import { table_display, table_render, border_draw } from "../screen/screen.js";
 import * as readline from "readline";
+import { chiliErrLog, chiliLog } from "../screen/output.js";
 /**
  * Base handler for groups of ChRIS resources.
  * Provides common functionality for listing and deleting resources.
  */
 export class BaseGroupHandler {
-    constructor(assetName, chrisObject) {
+    constructor(assetName, chrisObject = null) {
         this.assetName = "";
         this.assetName = assetName;
         this.chrisObject = chrisObject;
@@ -22,6 +23,17 @@ export class BaseGroupHandler {
             title: { title: this.assetName, justification: "center" },
         };
     }
+    /**
+     * The resolved ChRIS context, for use inside actions. Throws if read before
+     * the context has been set — a lazy handler must resolve its context before
+     * an action dereferences it.
+     */
+    get chrisObjectResolved() {
+        if (!this.chrisObject) {
+            throw new Error(`ChRIS context for '${this.assetName}' is not available in the current context.`);
+        }
+        return this.chrisObject;
+    }
     /**
      * Lists ChRIS resources based on provided CLI options.
      *
@@ -49,13 +61,13 @@ export class BaseGroupHandler {
                 options.fields = cleanFields.join(',');
             }
             const params = options_toParams(options);
-            const results = await this.chrisObject.asset.resources_listAndFilterByOptions(params);
+            const results = await this.chrisObjectResolved.asset.resources_listAndFilterByOptions(params);
             if (!results) {
-                console.error(`No ${this.assetName} resources found. Perhaps check your current context?`);
+                chiliErrLog(`No ${this.assetName} resources found. Perhaps check your current context?`);
                 return;
             }
             if (results.tableData.length === 0) {
-                console.log(`No ${this.assetName} found matching the criteria.`);
+                chiliLog(`No ${this.assetName} found matching the criteria.`);
             }
             else {
                 const uniqueResults = resourceColumns_removeDuplicates(results);
@@ -73,7 +85,7 @@ export class BaseGroupHandler {
                             return `"${String(val !== undefined ? val : '').split('"').join('""')}"`;
                         }).join(',');
                     }).join('\n');
-                    console.log(header + '\n' + rows);
+                    chiliLog(header + '\n' + rows);
                 }
                 else if (options.table) {
                     // Explicit Table format (with borders and title)
@@ -104,7 +116,7 @@ export class BaseGroupHandler {
             }
         }
         catch (error) {
-            console.log(errorStack.stack_search(this.assetName)[0]);
+            chiliLog(errorStack.stack_search(this.assetName)[0]);
         }
     }
     /**
@@ -112,20 +124,20 @@ export class BaseGroupHandler {
      */
     async resourceFields_list() {
         try {
-            const results = await this.chrisObject.asset.resourceFields_get();
+            const results = await this.chrisObjectResolved.asset.resourceFields_get();
             if (!results) {
-                console.error(`An error occurred while fetching resource fields for ${this.assetName}.`);
+                chiliErrLog(`An error occurred while fetching resource fields for ${this.assetName}.`);
                 return;
             }
             if (results.fields.length === 0) {
-                console.log(`No resource fields found for ${this.assetName}.`);
+                chiliLog(`No resource fields found for ${this.assetName}.`);
             }
             else {
                 table_display(results.fields, ["fields"]);
             }
         }
         catch (error) {
-            console.log(errorStack.stack_search(this.assetName)[0]);
+            chiliLog(errorStack.stack_search(this.assetName)[0]);
         }
     }
     /**
@@ -138,7 +150,7 @@ export class BaseGroupHandler {
      */
     async resourceFields_render() {
         try {
-            const results = await this.chrisObject.asset.resourceFields_get();
+            const results = await this.chrisObjectResolved.asset.resourceFields_get();
             if (!results) {
                 return envelope_error('', undefined, `An error occurred while fetching resource fields for ${this.assetName}.\n`);
             }
@@ -240,21 +252,21 @@ export class BaseGroupHandler {
         let OKorNot = "";
         for (const id of IDs) {
             try {
-                const searchResults = await this.chrisObject.asset.resources_listAndFilterByOptions({
+                const searchResults = await this.chrisObjectResolved.asset.resources_listAndFilterByOptions({
                     id: id,
                 });
-                console.log(border_draw(`checking ${this.assetName} id ${id} ... ${this.msg_OKorNot(searchResults)}`));
+                chiliLog(border_draw(`checking ${this.assetName} id ${id} ... ${this.msg_OKorNot(searchResults)}`));
                 if (!force) {
                     confirm = await this.user_confirmContinuation(id, "delete");
                     if (!confirm) {
                         continue;
                     }
                 }
-                delop = await this.chrisObject.asset.resourceItem_delete(id);
+                delop = await this.chrisObjectResolved.asset.resourceItem_delete(id);
                 border_draw(`deleting ${this.assetName} id ${id} ... ${this.msg_OKorNot(true)}`);
             }
             catch (error) {
-                console.error(`${error}`);
+                chiliErrLog(`${error}`);
                 return false;
             }
         }
@@ -268,7 +280,7 @@ export class BaseGroupHandler {
      */
     async IDs_getFromSearch(options) {
         const params = options_toParams(options);
-        const searchResults = await this.chrisObject.asset.resources_listAndFilterByOptions(params);
+        const searchResults = await this.chrisObjectResolved.asset.resources_listAndFilterByOptions(params);
         if (!searchResults) {
             return null;
         }
@@ -284,7 +296,7 @@ export class BaseGroupHandler {
         let nIDs;
         nIDs = await this.IDs_getFromSearch(options);
         if (!nIDs) {
-            console.error(`No ${this.assetName} matched the search criteria.`);
+            chiliErrLog(`No ${this.assetName} matched the search criteria.`);
             return;
         }
         if (nIDs) {
@@ -334,7 +346,7 @@ export class BaseGroupHandler {
             .option("-f, --force", `force the deletion without prompting for user confirmation`)
             .action(async (searchable, options) => {
             const searchParts = searchable.split("++").map((part) => part.trim());
-            // console.log(`searchParts = ${searchParts}`);
+            // chiliLog(`searchParts = ${searchParts}`);
             for (const searchPart of searchParts) {
                 const currentOptions = {
                     ...options,

package/dist/index.js

@@ -11,6 +11,7 @@
  */
 import omelette from "omelette";
 import { run } from "./run.js";
+import { chiliErrLog, chiliLog } from "./screen/output.js";
 /**
  * Sets up shell command completion for the standalone chili CLI using omelette.
  * This is a bin-only concern; in-process hosts provide their own completion.
@@ -50,7 +51,7 @@ function commandCompletion_setup() {
         },
     });
     completion.on("man.doc", ({ reply }) => {
-        console.log("Autocomplete triggered for man doc command");
+        chiliLog("Autocomplete triggered for man doc command");
         reply([]);
     });
     completion.init();
@@ -66,7 +67,7 @@ async function main() {
     await run(process.argv.slice(2));
 }
 main().catch((error) => {
-    console.error("An error occurred:", error);
+    chiliErrLog("An error occurred:", error);
     process.exit(1);
 });
 // Re-export library utilities for consumers that import the package root.

package/dist/lfs/lfs.js

@@ -8,6 +8,8 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import { table_render } from "../screen/screen.js";
+import { chiliErrLog, chiliLog } from "../screen/output.js";
 /**
  * Lists the contents of a directory with details.
  *
@@ -22,10 +24,10 @@ export async function dirContents_list(filepath) {
             return { filename: file, "size(KB)": size, created_at: birthtime };
         });
         const detailedFiles = await Promise.all(detailedFilesPromises);
-        console.table(detailedFiles);
+        chiliLog(table_render(detailedFiles, ["filename", "size(KB)", "created_at"]));
     }
     catch (error) {
-        console.error("Error occurred while reading the directory!", error);
+        chiliErrLog("Error occurred while reading the directory!", error);
     }
 }
 /**
@@ -36,7 +38,7 @@ export async function dirContents_list(filepath) {
 export function dir_create(filepath) {
     if (!fs.existsSync(filepath)) {
         fs.mkdirSync(filepath);
-        console.log("The directory has been created successfully");
+        chiliLog("The directory has been created successfully");
     }
 }
 /**
@@ -46,7 +48,7 @@ export function dir_create(filepath) {
  */
 export function file_create(filepath) {
     fs.openSync(filepath, "w");
-    console.log("An empty file has been created");
+    chiliLog("An empty file has been created");
 }
 /**
  * Sets up the 'lfs' command group in Commander.

package/dist/man/man.js

@@ -1,5 +1,6 @@
 import { topics_list } from "../commands/man/topics.js";
 import { manPage_display } from "../commands/man/doc.js";
+import { chiliLog } from "../screen/output.js";
 /**
  * Sets up the 'man' command for displaying ChILI manual and help pages.
  *
@@ -24,8 +25,8 @@ export function manCommand_setup(program) {
         .description("List the available manual page topics")
         .action(async () => {
         const files = await topics_list();
-        console.log("\n\nThe following topics are available:");
-        console.log("(read more with 'chili man doc <topic>')\n");
-        console.log(files.join("\n"));
+        chiliLog("\n\nThe following topics are available:");
+        chiliLog("(read more with 'chili man doc <topic>')\n");
+        chiliLog(files.join("\n"));
     });
 }

package/dist/man/renderer.js

@@ -9,6 +9,7 @@ import chalk from "chalk";
 import { convert as adoc_convert } from "asciidoctor";
 import { exec } from "child_process";
 import os from "os";
+import { chiliErrLog } from "../screen/output.js";
 const headingStyles = [
     { regex: /<h1.*?>(.*?)<\/h1>/g, font: "Standard", color: chalk.magenta },
     { regex: /<h2.*?>(.*?)<\/h2>/g, font: "Slant", color: chalk.yellow },
@@ -175,11 +176,11 @@ export async function browser_open(filePath) {
                 : "xdg-open";
         exec(`${command} ${tempHtmlPath}`, (error) => {
             if (error) {
-                console.error("Error opening browser:", error);
+                chiliErrLog("Error opening browser:", error);
             }
         });
     }
     catch (error) {
-        console.error("Error opening documentation in browser:", error instanceof Error ? error.message : String(error));
+        chiliErrLog("Error opening documentation in browser:", error instanceof Error ? error.message : String(error));
     }
 }

package/dist/pacs/pacsQueryHandler.js

@@ -9,6 +9,7 @@ import { BaseGroupHandler } from "../handlers/baseGroupHandler.js";
 import { border_draw } from "../screen/screen.js";
 import { pacsQueryResult_renderPretty } from "./pacsResultRender.js";
 import { pacsQueryPayload_build } from "./pacsQueryPayload.js";
+import { chiliLog } from "../screen/output.js";
 /**
  * Handler for PACS queries commands.
  */
@@ -69,7 +70,7 @@ export class PACSQueryGroupHandler {
         const listCommand = this.baseGroupHandler.baseListCommand_create(async (options) => {
             const pacsserver = await this.pacsserverContext_resolve(options.pacsserver);
             if (!pacsserver) {
-                console.log(border_draw("No PACS server in context. Use --pacsserver or set via context."));
+                chiliLog(border_draw("No PACS server in context. Use --pacsserver or set via context."));
                 return;
             }
             const mergedOptions = this.options_withPACSFilter(options, pacsserver);
@@ -111,17 +112,17 @@ export class PACSQueryGroupHandler {
             }
             const payload = pacsQueryPayload_build(queryInput, options.title, options.description);
             if (!payload) {
-                console.log(border_draw("Invalid query format. Provide JSON or comma-separated key:value pairs."));
+                chiliLog(border_draw("Invalid query format. Provide JSON or comma-separated key:value pairs."));
                 return;
             }
             const result = await pacsQueries_create(pacsserver, payload);
             if (!result.ok) {
                 const errors = errorStack_getAllOfType("error");
                 if (errors.length) {
-                    errors.forEach((msg) => console.log(border_draw(msg)));
+                    errors.forEach((msg) => chiliLog(border_draw(msg)));
                 }
                 else {
-                    console.log(border_draw("Failed to create PACS query."));
+                    chiliLog(border_draw("Failed to create PACS query."));
                 }
                 return;
             }
@@ -133,7 +134,7 @@ export class PACSQueryGroupHandler {
                 `pacs=${pacsserver}`,
                 `title="${created.title ?? options.title ?? ""}"`,
             ].join(" ");
-            console.log(border_draw(msg.trim()));
+            chiliLog(border_draw(msg.trim()));
         });
     }
     /**
@@ -149,17 +150,17 @@ export class PACSQueryGroupHandler {
             .action(async (queryId, options) => {
             const idNum = Number(queryId);
             if (Number.isNaN(idNum)) {
-                console.log(border_draw("queryId must be a number."));
+                chiliLog(border_draw("queryId must be a number."));
                 return;
             }
             const result = await pacsQuery_resultDecode(idNum);
             if (!result.ok) {
                 const errors = errorStack_getAllOfType("error");
                 if (errors.length) {
-                    errors.forEach((msg) => console.log(border_draw(msg)));
+                    errors.forEach((msg) => chiliLog(border_draw(msg)));
                 }
                 else {
-                    console.log(border_draw(`Failed to decode PACS query result for ${idNum}.`));
+                    chiliLog(border_draw(`Failed to decode PACS query result for ${idNum}.`));
                 }
                 return;
             }
@@ -167,23 +168,23 @@ export class PACSQueryGroupHandler {
             // Prefer JSON, then text, else indicate base64 length
             if (decoded.json !== undefined) {
                 if (options.raw) {
-                    console.log(border_draw(JSON.stringify(decoded.json, null, 2)));
+                    chiliLog(border_draw(JSON.stringify(decoded.json, null, 2)));
                     return;
                 }
                 const pretty = this.pacsResult_renderPretty(decoded.json);
                 if (pretty) {
-                    console.log(border_draw(pretty));
+                    chiliLog(border_draw(pretty));
                 }
                 else {
-                    console.log(border_draw(JSON.stringify(decoded.json, null, 2)));
+                    chiliLog(border_draw(JSON.stringify(decoded.json, null, 2)));
                 }
             }
             else if (decoded.text) {
-                console.log(border_draw(decoded.text));
+                chiliLog(border_draw(decoded.text));
             }
             else {
                 const len = decoded.raw.length;
-                console.log(border_draw(`Decoded payload available (base64 length ${len}), but not printable.`));
+                chiliLog(border_draw(`Decoded payload available (base64 length ${len}), but not printable.`));
             }
         });
     }

package/dist/pacs/pacsRetrieveHandler.js

@@ -6,6 +6,7 @@
 import { errorStack_getAllOfType, } from "@fnndsc/cumin";
 import { pacsRetrieve_create, pacsRetrieve_delete, pacsRetrieve_statusForQuery, } from "@fnndsc/salsa";
 import { border_draw } from "../screen/screen.js";
+import { chiliLog } from "../screen/output.js";
 /**
  * Handler for PACS retrieve commands.
  */
@@ -52,17 +53,17 @@ export class PACSRetrieveGroupHandler {
     async retrieve_pull(queryIdStr) {
         const queryId = Number(queryIdStr);
         if (Number.isNaN(queryId)) {
-            console.log(border_draw("Query ID must be a number."));
+            chiliLog(border_draw("Query ID must be a number."));
             return;
         }
         const result = await pacsRetrieve_create(queryId);
         if (!result.ok) {
             const errors = errorStack_getAllOfType("error");
             if (errors.length) {
-                errors.forEach((msg) => console.log(border_draw(msg)));
+                errors.forEach((msg) => chiliLog(border_draw(msg)));
             }
             else {
-                console.log(border_draw(`Failed to create PACS retrieve for query ${queryId}.`));
+                chiliLog(border_draw(`Failed to create PACS retrieve for query ${queryId}.`));
             }
             return;
         }
@@ -73,7 +74,7 @@ export class PACSRetrieveGroupHandler {
             `query=${queryId}`,
             `status=${record.status || "created"}`,
         ].join(" ");
-        console.log(border_draw(msg));
+        chiliLog(border_draw(msg));
     }
     /**
      * Handle the 'report' command - show detailed status.
@@ -83,23 +84,23 @@ export class PACSRetrieveGroupHandler {
     async retrieve_report(queryIdStr) {
         const queryId = Number(queryIdStr);
         if (Number.isNaN(queryId)) {
-            console.log(border_draw("Query ID must be a number."));
+            chiliLog(border_draw("Query ID must be a number."));
             return;
         }
         const result = await pacsRetrieve_statusForQuery(queryId);
         if (!result.ok) {
             const errors = errorStack_getAllOfType("error");
             if (errors.length) {
-                errors.forEach((msg) => console.log(border_draw(msg)));
+                errors.forEach((msg) => chiliLog(border_draw(msg)));
             }
             else {
-                console.log(border_draw(`Failed to generate status report for query ${queryId}.`));
+                chiliLog(border_draw(`Failed to generate status report for query ${queryId}.`));
             }
             return;
         }
         const report = result.value;
         const rendered = this.report_render(report);
-        console.log(border_draw(rendered));
+        chiliLog(border_draw(rendered));
     }
     /**
      * Handle the 'cancel' command - delete a retrieve.
@@ -109,21 +110,21 @@ export class PACSRetrieveGroupHandler {
     async retrieve_cancel(retrieveIdStr) {
         const retrieveId = Number(retrieveIdStr);
         if (Number.isNaN(retrieveId)) {
-            console.log(border_draw("Retrieve ID must be a number."));
+            chiliLog(border_draw("Retrieve ID must be a number."));
             return;
         }
         const result = await pacsRetrieve_delete(retrieveId);
         if (!result.ok) {
             const errors = errorStack_getAllOfType("error");
             if (errors.length) {
-                errors.forEach((msg) => console.log(border_draw(msg)));
+                errors.forEach((msg) => chiliLog(border_draw(msg)));
             }
             else {
-                console.log(border_draw(`Failed to cancel PACS retrieve ${retrieveId}.`));
+                chiliLog(border_draw(`Failed to cancel PACS retrieve ${retrieveId}.`));
             }
             return;
         }
-        console.log(border_draw(`PACS retrieve ${retrieveId} cancelled.`));
+        chiliLog(border_draw(`PACS retrieve ${retrieveId} cancelled.`));
     }
     /**
      * Determine overall completion status from series statuses.

package/dist/path/pathCommand.js

@@ -16,6 +16,7 @@ import open from "open";
 import { execFile } from "child_process";
 import os from "os";
 import { files_downloadWithProgress } from "../commands/fs/download.js";
+import { chiliErrLog, chiliLog } from "../screen/output.js";
 /**
  * Creates a summary table for file transfer details.
  *
@@ -166,7 +167,7 @@ async function mermaid_renderServerSide(mermaidDefinition, outputFile) {
     return new Promise((resolve, reject) => {
         execFile("npx", ["mmdc", "-i", inputFile, "-o", outputFile], (error) => {
             if (error) {
-                console.error(`Mermaid render failed. Ensure @mermaid-js/mermaid-cli is available (npx mmdc): ${error.message}`);
+                chiliErrLog(`Mermaid render failed. Ensure @mermaid-js/mermaid-cli is available (npx mmdc): ${error.message}`);
                 reject(error);
                 return;
             }
@@ -412,10 +413,10 @@ async function scanResult_render(scanResult, options) {
             try {
                 const outputFile = path.resolve(options.save);
                 const savedFilePath = await mermaid_renderServerSide(mermaidDefinition, outputFile);
-                console.log(`Mermaid diagram saved to: ${savedFilePath}`);
+                chiliLog(`Mermaid diagram saved to: ${savedFilePath}`);
             }
             catch (error) {
-                console.error(`Failed to save Mermaid diagram: ${error}`);
+                chiliErrLog(`Failed to save Mermaid diagram: ${error}`);
             }
         }
         else {
@@ -424,16 +425,16 @@ async function scanResult_render(scanResult, options) {
         return;
     }
     if (options.tree) {
-        console.log(archyTree_create(scanResult.fileInfo));
+        chiliLog(archyTree_create(scanResult.fileInfo));
         return;
     }
     if (!options.silent) {
         for (const file of scanResult.fileInfo) {
             if (file.isLink && !options.follow) {
-                console.log(`${file.chrisPath} -> ${file.linkTarget}`);
+                chiliLog(`${file.chrisPath} -> ${file.linkTarget}`);
             }
             else {
-                console.log(`${file.chrisPath}`);
+                chiliLog(`${file.chrisPath}`);
             }
         }
     }
@@ -447,24 +448,24 @@ async function scanResult_render(scanResult, options) {
 export async function scan_do(options) {
     const chrisFolder = await chrisContext.current_get(Context.ChRISfolder);
     if (!chrisFolder) {
-        console.error(chalk.red("No ChRIS folder context set. Use 'folder=' to set a context."));
+        chiliErrLog(chalk.red("No ChRIS folder context set. Use 'folder=' to set a context."));
         return null;
     }
     if (!options.silent) {
-        console.log(chalk.cyan(`Scanning for ${options.dirsOnly ? "directories" : "all files"} recursively from ${chrisFolder}`));
+        chiliLog(chalk.cyan(`Scanning for ${options.dirsOnly ? "directories" : "all files"} recursively from ${chrisFolder}`));
     }
     const hostBasePath = options.hostpath || process.cwd();
     const scanResult = await chrisFS_scan(chrisFolder, hostBasePath, options.follow, options.dirsOnly);
     if (!scanResult) {
-        console.error(chalk.red("Failed to scan ChRIS filesystem."));
+        chiliErrLog(chalk.red("Failed to scan ChRIS filesystem."));
         return null;
     }
     const filtered = scanResult_filter(scanResult, options);
     await scanResult_render(filtered, options);
     if (!options.silent) {
-        console.log(chalk.green(`Total size: ${bytes_format(filtered.totalSize)}`));
+        chiliLog(chalk.green(`Total size: ${bytes_format(filtered.totalSize)}`));
         if (options.filter || options.endsWith) {
-            console.log(chalk.cyan(`Filtered results: ${filtered.fileInfo.length} items`));
+            chiliLog(chalk.cyan(`Filtered results: ${filtered.fileInfo.length} items`));
         }
     }
     return filtered;
@@ -517,25 +518,25 @@ async function localFS_scan(options) {
     await chrisContext.currentContext_update();
     const folder = chrisContext.singleContext.folder;
     if (!folder) {
-        console.error("ChRIS folder context is undefined, cannot initialize chrisIO.");
+        chiliErrLog("ChRIS folder context is undefined, cannot initialize chrisIO.");
         return null;
     }
     // Validate that the folder context exists in CUBE before proceeding
     try {
         const testGroup = await objContext_create("ChRISDirsContext", `folder:${folder}`);
         if (!testGroup) {
-            console.error(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
+            chiliErrLog(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
             return null;
         }
     }
     catch (error) {
-        console.error(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
+        chiliErrLog(chalk.red(`Folder context '${folder}' does not exist in CUBE. Please specify an existing directory.`));
         return null;
     }
     // Folder exists, so just set chrisFolder without calling init()
     // (init() tries to CREATE the folder which will fail if it already exists)
     chrisIO.chrisFolder = folder;
-    console.log(border_draw(chalk.cyan("Scanning files to upload...")));
+    chiliLog(border_draw(chalk.cyan("Scanning files to upload...")));
     const filesToUpload = await filesToUpload_get(options.hostpath, folder);
     let totalSize = 0;
     for (const file of filesToUpload) {
@@ -643,12 +644,12 @@ async function chris_pull(scanRecord, progressBar) {
             }
             else {
                 summary.failedCount++;
-                console.log(chalk.yellow(`Failed to download: ${file.hostPath}`));
+                chiliLog(chalk.yellow(`Failed to download: ${file.hostPath}`));
             }
         }
         catch (error) {
             summary.failedCount++;
-            console.log(chalk.red(`Error downloading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
+            chiliLog(chalk.red(`Error downloading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
         }
         progressBar.update(index + 1, {
             bytes: bytes_format(summary.transferSize), // Renamed
@@ -685,12 +686,12 @@ async function chris_push(scanRecord, progressBar) {
             }
             else {
                 summary.failedCount++;
-                console.log(chalk.yellow(`Failed to upload: ${file.hostPath}`));
+                chiliLog(chalk.yellow(`Failed to upload: ${file.hostPath}`));
             }
         }
         catch (error) {
             summary.failedCount++;
-            console.log(chalk.red(`Error uploading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
+            chiliLog(chalk.red(`Error uploading ${file.hostPath}: ${error instanceof Error ? error.message : String(error)}`));
         }
         progressBar.update(index + 1, {
             bytes: bytes_format(summary.transferSize), // Renamed
@@ -713,7 +714,7 @@ async function download_handle(options) {
     await chrisContext.currentContext_update();
     const folder = chrisContext.singleContext.folder;
     if (!folder) {
-        console.error(chalk.red("No ChRIS folder context set. Use 'connect' to establish a session."));
+        chiliErrLog(chalk.red("No ChRIS folder context set. Use 'connect' to establish a session."));
         return false;
     }
     const localTarget = path.resolve(options.hostpath || process.cwd());
@@ -728,7 +729,7 @@ async function download_handle(options) {
     }
     catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
-        console.error(chalk.red(`Download failed: ${msg}`));
+        chiliErrLog(chalk.red(`Download failed: ${msg}`));
         return false;
     }
 }
@@ -788,7 +789,7 @@ export async function pathCommand_setup(program) {
             hostpath: hostpath || process.cwd(),
             force: options.force,
         });
-        console.log(result);
+        chiliLog(result);
     });
     pathCommand
         .command("scan")

package/dist/plugins/pluginGroupHandler.d.ts

@@ -13,16 +13,27 @@ export declare class PluginContextGroupHandler {
     private baseGroupHandler;
     private controller;
     readonly assetName: string;
+    private readonly id?;
     private constructor();
     /**
-     * Factory method to create a new PluginContextGroupHandler instance.
+     * Creates a PluginContextGroupHandler for an asset type. This performs no
+     * network work and resolves no plugin context — command registration needs
+     * only the asset name; the controller is resolved lazily on first action (see
+     * {@link controller_ensure}).
      *
-     * @param assetName - The type of plugin context to handle ('computesofplugin', 'instancesofplugin', 'parametersofplugin').
-     * @param id - Optional plugin ID. Defaults to current ChRIS plugin context.
-     * @returns A Promise resolving to a new PluginContextGroupHandler instance.
-     * @throws InitializationError if an unsupported asset type is provided.
+     * @param assetName - The type of plugin context ('computesofplugin', 'instancesofplugin', 'parametersofplugin').
+     * @param id - Optional plugin ID the context binds to; defaults to the current plugin context.
+     * @returns A new PluginContextGroupHandler instance.
      */
-    static handler_create(assetName: string, id?: number | null): Promise<PluginContextGroupHandler>;
+    static handler_create(assetName: string, id?: number | null): PluginContextGroupHandler;
+    /**
+     * Lazily resolves and memoizes the plugin-context controller against the bound
+     * plugin id (or the current ChRIS context), wiring it into the
+     * registration-only base handler so its actions can read the context.
+     *
+     * @returns The controller, or null if the context cannot be resolved here.
+     */
+    private controller_ensure;
     /**
      * Lists plugin parameters in a "man page" style format.
      * This is a specialized view for parameters that differs from the standard table view.