hostctl 0.1.47 → 0.1.49

package/dist/bin/hostctl.js

@@ -3886,11 +3886,168 @@ var LocalRuntime = class {
   }
 };
 
+// src/zip.ts
+import AdmZip from "adm-zip";
+
+// src/hash.ts
+import { createHash } from "crypto";
+
+// src/param-map.ts
+import { match as match2 } from "ts-pattern";
+var ParamMap = class _ParamMap {
+  /**
+   * Parses CLI arguments of the form key:value, only supporting top-level keys.
+   * Only the first colon is treated as a key/value separator; all subsequent colons are part of the value.
+   * This means nested keys are not supported, but values can contain colons (e.g., URLs, JSON, etc.).
+   */
+  static parse(cliArguments) {
+    const root = new _ParamMap();
+    A2(cliArguments).each((arg) => {
+      const idx = arg.indexOf(":");
+      if (idx === -1) {
+        root.set([arg], "true");
+        return;
+      }
+      const key = arg.slice(0, idx);
+      const value = arg.slice(idx + 1);
+      root.set([key], value);
+    });
+    return root;
+  }
+  map;
+  constructor() {
+    this.map = /* @__PURE__ */ new Map();
+  }
+  get(keyPath) {
+    const keys3 = keyPath.split(":");
+    let node = this;
+    for (let i = 0; i < keys3.length; i++) {
+      if (!(node instanceof _ParamMap)) return void 0;
+      node = node.map.get(keys3[i]);
+      if (node === void 0) return void 0;
+    }
+    if (node instanceof _ParamMap) {
+      return node.toObject();
+    }
+    return this.stringToJsonObj(node);
+  }
+  set(keyPath, value) {
+    const keyParts = Array.isArray(keyPath) ? keyPath : keyPath.split(":");
+    let node = this;
+    for (let i = 0; i < keyParts.length - 1; i++) {
+      const key = keyParts[i];
+      let nextNode = node.map.get(key);
+      if (!(nextNode instanceof _ParamMap)) {
+        nextNode = new _ParamMap();
+        node.map.set(key, nextNode);
+      }
+      node = nextNode;
+    }
+    const lastKey = keyParts[keyParts.length - 1];
+    node.map.set(lastKey, value);
+  }
+  toObject() {
+    let obj = {};
+    M(this.map).each(([k, v]) => {
+      obj[k] = v instanceof _ParamMap ? v.toObject() : this.stringToJsonObj(v);
+    });
+    return obj;
+  }
+  stringToJsonObj(str) {
+    if (typeof str !== "string") return str;
+    const trimmed = str.trim();
+    if (trimmed.startsWith("{") && trimmed.endsWith("}") || trimmed.startsWith("[") && trimmed.endsWith("]")) {
+      try {
+        return JSON.parse(trimmed);
+      } catch {
+      }
+    }
+    return match2(str).when(matches(/,/), (s) => {
+      return VP(s.split(",")).map((v) => v.trim()).compact([""]).map((v) => this.stringToJsonObj(v)).value;
+    }).when(isNumeric, (s) => parseFloat(s)).when(
+      (s) => s.trim() === "",
+      () => ""
+    ).otherwise(() => str);
+  }
+};
+
+// src/runtime.ts
+import * as z from "zod";
+
+// src/version.ts
+var version = "0.1.49";
+
+// src/app.ts
+import { retryUntilDefined } from "ts-retry";
+import { Mutex as Mutex3 } from "async-mutex";
+import { match as match5 } from "ts-pattern";
+
+// src/core/remote/runAllRemote.ts
+var RunParamsSchema = z.object({
+  taskFn: z.custom((value) => typeof value === "function", {
+    message: "taskFn must be a function"
+  }),
+  params: z.any()
+});
+var RunResultSchema = z.record(z.string(), z.any());
+function serializeError(value) {
+  if (value instanceof Error) {
+    const err = value;
+    return {
+      error: err.message,
+      name: err.name,
+      code: err.code,
+      stack: err.stack
+    };
+  }
+  if (value && typeof value === "object") {
+    return { error: JSON.stringify(value) };
+  }
+  return { error: String(value) };
+}
+async function run(context) {
+  const { params, ssh } = context;
+  const { taskFn, params: taskParams } = params;
+  const remoteResults = await ssh([], async (remoteContext) => {
+    const hostIdentifier = remoteContext.host?.alias || remoteContext.host?.shortName || "unknown_remote_host";
+    remoteContext.debug(`[${hostIdentifier}] Connected via SSH.`);
+    try {
+      const result = await remoteContext.run(taskFn(taskParams));
+      remoteContext.debug(`[${hostIdentifier}] Remote task result:`, JSON.stringify(result));
+      if (result instanceof Error) {
+        remoteContext.warn?.(
+          `[${hostIdentifier}] Remote task returned an Error instance. Converting to serializable object.`
+        );
+        return serializeError(result);
+      }
+      return result;
+    } catch (e) {
+      remoteContext.debug(`[${hostIdentifier}] Failed to run remote task:`, e.message);
+      return serializeError(e);
+    }
+  });
+  const normalizedEntries = Object.entries(remoteResults ?? {}).map(([hostAlias, value]) => {
+    if (value instanceof Error) {
+      return [hostAlias, serializeError(value)];
+    }
+    return [hostAlias, value];
+  });
+  return Object.fromEntries(normalizedEntries);
+}
+var runAllRemote_default = task(run, {
+  description: "run a task on all selected hosts",
+  inputSchema: RunParamsSchema,
+  outputSchema: RunResultSchema
+});
+
+// src/commands/pkg/package-manager.ts
+import { promises as fs6 } from "fs";
+
 // src/node-runtime.ts
 import os3 from "os";
 import axios2 from "axios";
 import * as cheerio from "cheerio";
-import { match as match3 } from "ts-pattern";
+import { match as match4 } from "ts-pattern";
 import which from "which";
 
 // src/http.ts
@@ -3935,14 +4092,14 @@ async function downloadFile(url, dest) {
 import decompress from "decompress";
 import decompressTarGzPlugin from "decompress-targz";
 import decompressZipPlugin from "decompress-unzip";
-import { match as match2, P as P2 } from "ts-pattern";
+import { match as match3, P as P2 } from "ts-pattern";
 import decompressTarPlugin from "decompress-tar";
 import { fileTypeFromBuffer } from "file-type";
 import { getStreamAsBuffer } from "get-stream";
 import xzdecompress from "xz-decompress";
 async function unarchive(inputPath, outputPath) {
   const filename = File.basename(inputPath);
-  return await match2(filename).with(P2.string.regex(/.tar.xz$/), () => decompressTarXz(inputPath, outputPath)).with(P2.string.regex(/.tar.gz$/), () => decompressTarGz(inputPath, outputPath)).with(P2.string.regex(/.zip$/), () => decompressZip(inputPath, outputPath)).otherwise(() => {
+  return await match3(filename).with(P2.string.regex(/.tar.xz$/), () => decompressTarXz(inputPath, outputPath)).with(P2.string.regex(/.tar.gz$/), () => decompressTarGz(inputPath, outputPath)).with(P2.string.regex(/.zip$/), () => decompressZip(inputPath, outputPath)).otherwise(() => {
     throw new Error(`unable to decompress unknown file type: ${inputPath}`);
   });
 }
@@ -4057,8 +4214,8 @@ var NodeRuntime = class _NodeRuntime {
   }
   // returns the path to the downloaded zip file
   async downloadNodePackage(platform2, arch) {
-    const platformInFilename = match3(platform2).with("linux", () => "linux").with("win32", () => "win").with("darwin", () => "darwin").otherwise(() => "unknown-platform");
-    const archInFilename = match3(arch).with("x64", () => "x64").with("x86", () => "x86").with("arm", () => "armv7l").with("arm64", () => "arm64").otherwise(() => "unknown-arch");
+    const platformInFilename = match4(platform2).with("linux", () => "linux").with("win32", () => "win").with("darwin", () => "darwin").otherwise(() => "unknown-platform");
+    const archInFilename = match4(arch).with("x64", () => "x64").with("x86", () => "x86").with("arm", () => "armv7l").with("arm64", () => "arm64").otherwise(() => "unknown-arch");
     const packages = await this.listPackages();
     const url = A2(packages).find((url2) => url2.match(`node-v.*-${platformInFilename}-${archInFilename}`));
     if (V.isAbsent(url)) {
@@ -4122,162 +4279,7 @@ var NodeRuntime = class _NodeRuntime {
   }
 };
 
-// src/zip.ts
-import AdmZip from "adm-zip";
-
-// src/hash.ts
-import { createHash } from "crypto";
-
-// src/param-map.ts
-import { match as match4 } from "ts-pattern";
-var ParamMap = class _ParamMap {
-  /**
-   * Parses CLI arguments of the form key:value, only supporting top-level keys.
-   * Only the first colon is treated as a key/value separator; all subsequent colons are part of the value.
-   * This means nested keys are not supported, but values can contain colons (e.g., URLs, JSON, etc.).
-   */
-  static parse(cliArguments) {
-    const root = new _ParamMap();
-    A2(cliArguments).each((arg) => {
-      const idx = arg.indexOf(":");
-      if (idx === -1) {
-        root.set([arg], "true");
-        return;
-      }
-      const key = arg.slice(0, idx);
-      const value = arg.slice(idx + 1);
-      root.set([key], value);
-    });
-    return root;
-  }
-  map;
-  constructor() {
-    this.map = /* @__PURE__ */ new Map();
-  }
-  get(keyPath) {
-    const keys3 = keyPath.split(":");
-    let node = this;
-    for (let i = 0; i < keys3.length; i++) {
-      if (!(node instanceof _ParamMap)) return void 0;
-      node = node.map.get(keys3[i]);
-      if (node === void 0) return void 0;
-    }
-    if (node instanceof _ParamMap) {
-      return node.toObject();
-    }
-    return this.stringToJsonObj(node);
-  }
-  set(keyPath, value) {
-    const keyParts = Array.isArray(keyPath) ? keyPath : keyPath.split(":");
-    let node = this;
-    for (let i = 0; i < keyParts.length - 1; i++) {
-      const key = keyParts[i];
-      let nextNode = node.map.get(key);
-      if (!(nextNode instanceof _ParamMap)) {
-        nextNode = new _ParamMap();
-        node.map.set(key, nextNode);
-      }
-      node = nextNode;
-    }
-    const lastKey = keyParts[keyParts.length - 1];
-    node.map.set(lastKey, value);
-  }
-  toObject() {
-    let obj = {};
-    M(this.map).each(([k, v]) => {
-      obj[k] = v instanceof _ParamMap ? v.toObject() : this.stringToJsonObj(v);
-    });
-    return obj;
-  }
-  stringToJsonObj(str) {
-    if (typeof str !== "string") return str;
-    const trimmed = str.trim();
-    if (trimmed.startsWith("{") && trimmed.endsWith("}") || trimmed.startsWith("[") && trimmed.endsWith("]")) {
-      try {
-        return JSON.parse(trimmed);
-      } catch {
-      }
-    }
-    return match4(str).when(matches(/,/), (s) => {
-      return VP(s.split(",")).map((v) => v.trim()).compact([""]).map((v) => this.stringToJsonObj(v)).value;
-    }).when(isNumeric, (s) => parseFloat(s)).when(
-      (s) => s.trim() === "",
-      () => ""
-    ).otherwise(() => str);
-  }
-};
-
-// src/runtime.ts
-import * as z from "zod";
-
-// src/version.ts
-var version = "0.1.47";
-
-// src/app.ts
-import { retryUntilDefined } from "ts-retry";
-import { Mutex as Mutex3 } from "async-mutex";
-import { match as match5 } from "ts-pattern";
-
-// src/core/remote/runAllRemote.ts
-var RunParamsSchema = z.object({
-  taskFn: z.custom((value) => typeof value === "function", {
-    message: "taskFn must be a function"
-  }),
-  params: z.any()
-});
-var RunResultSchema = z.record(z.string(), z.any());
-function serializeError(value) {
-  if (value instanceof Error) {
-    const err = value;
-    return {
-      error: err.message,
-      name: err.name,
-      code: err.code,
-      stack: err.stack
-    };
-  }
-  if (value && typeof value === "object") {
-    return { error: JSON.stringify(value) };
-  }
-  return { error: String(value) };
-}
-async function run(context) {
-  const { params, ssh } = context;
-  const { taskFn, params: taskParams } = params;
-  const remoteResults = await ssh([], async (remoteContext) => {
-    const hostIdentifier = remoteContext.host?.alias || remoteContext.host?.shortName || "unknown_remote_host";
-    remoteContext.debug(`[${hostIdentifier}] Connected via SSH.`);
-    try {
-      const result = await remoteContext.run(taskFn(taskParams));
-      remoteContext.debug(`[${hostIdentifier}] Remote task result:`, JSON.stringify(result));
-      if (result instanceof Error) {
-        remoteContext.warn?.(
-          `[${hostIdentifier}] Remote task returned an Error instance. Converting to serializable object.`
-        );
-        return serializeError(result);
-      }
-      return result;
-    } catch (e) {
-      remoteContext.debug(`[${hostIdentifier}] Failed to run remote task:`, e.message);
-      return serializeError(e);
-    }
-  });
-  const normalizedEntries = Object.entries(remoteResults ?? {}).map(([hostAlias, value]) => {
-    if (value instanceof Error) {
-      return [hostAlias, serializeError(value)];
-    }
-    return [hostAlias, value];
-  });
-  return Object.fromEntries(normalizedEntries);
-}
-var runAllRemote_default = task(run, {
-  description: "run a task on all selected hosts",
-  inputSchema: RunParamsSchema,
-  outputSchema: RunResultSchema
-});
-
 // src/commands/pkg/package-manager.ts
-import { promises as fs6 } from "fs";
 import filenamify from "filenamify";
 var PackageManager = class {
   constructor(app) {
@@ -4296,7 +4298,9 @@ var PackageManager = class {
         this.manifest = { packages: [], version: "1.0" };
       }
     } catch (error) {
-      console.warn("Failed to load manifest, creating new one:", error);
+      if (this.app.outputPlain()) {
+        console.warn("Failed to load manifest, creating new one:", error);
+      }
       this.manifest = { packages: [], version: "1.0" };
     }
   }
@@ -4455,8 +4459,8 @@ var PackageManager = class {
       const packageToRemove = this.findPackageToRemove(packageIdentifier);
       if (!packageToRemove) {
         return {
-          success: false,
-          error: `Package '${packageIdentifier}' not found. Use 'hostctl pkg list' to see installed packages.`
+          success: true,
+          warning: `Package '${packageIdentifier}' not found. Use 'hostctl pkg list' to see installed packages.`
         };
       }
       await this.removePackageFiles(packageToRemove);
@@ -4488,7 +4492,9 @@ var PackageManager = class {
         prefix: packagesDir.toString()
       });
     } catch (error) {
-      console.log(`DEBUG: Error during npm uninstall: ${error}`);
+      if (this.app.outputPlain()) {
+        console.log(`DEBUG: Error during npm uninstall: ${error}`);
+      }
     }
   }
   /**
@@ -4547,7 +4553,9 @@ var PackageManager = class {
       const installDir = packagesDir.join(filenamifiedSource);
       const existingPackage = this.findPackageBySource(normalizedSource);
       if (existingPackage) {
-        console.log(`Package '${existingPackage.name}' is already installed from ${normalizedSource}`);
+        if (this.app.outputPlain()) {
+          console.log(`Package '${existingPackage.name}' is already installed from ${normalizedSource}`);
+        }
         return {
           success: true,
           packageInfo: existingPackage,
@@ -4651,7 +4659,9 @@ var PackageManager = class {
   async findRealInstalledNpmPackagePath(packagesDir, source) {
     const nodeModulesPath = packagesDir.join("node_modules");
     if (!await nodeModulesPath.exists()) {
-      console.log(`DEBUG: node_modules does not exist at ${nodeModulesPath.toString()}`);
+      if (this.app.outputPlain()) {
+        console.log(`DEBUG: node_modules does not exist at ${nodeModulesPath.toString()}`);
+      }
       return { path: null, name: null };
     }
     const entries = await fs6.readdir(nodeModulesPath.toString());
@@ -4692,6 +4702,9 @@ var PackageManager = class {
   async handleDuplicateNames(finalPackageInfo) {
     const actualPackageName = finalPackageInfo.name;
     if (this.hasPackageWithName(actualPackageName)) {
+      if (!this.app.outputPlain()) {
+        return;
+      }
       const existingPackages = this.getPackagesWithName(actualPackageName);
       console.warn(`\u26A0\uFE0F  Warning: Package name '${actualPackageName}' already exists.`);
       console.warn(`   Existing packages:`);
@@ -6023,15 +6036,6 @@ ${successfullyUsedIdentityPaths}`);
       p = p.parent();
     }
   }
-  async printRuntimeReport() {
-    const nodeRuntime = new NodeRuntime(this.tmpDir);
-    const reportObj = {
-      nodePath: await nodeRuntime.nodePath(),
-      npmPath: await nodeRuntime.npmPath()
-      // summary: report?.getReport(),
-    };
-    this.info(reportObj);
-  }
   async promptPasswordInteractively(message = "Enter your password") {
     if (this.providedPassword !== void 0) {
       return this.providedPassword;
@@ -6050,11 +6054,6 @@ ${successfullyUsedIdentityPaths}`);
     this.providedPassword = await promptPassword({ message });
     return this.providedPassword;
   }
-  async installRuntime() {
-    this.info(`creating node runtime with ${this.tmpDir.toString()}`);
-    const nodeRuntime = new NodeRuntime(this.tmpDir);
-    await nodeRuntime.installIfNeeded();
-  }
   /**
    * Executes a command on the selected hosts
    *
@@ -6318,7 +6317,7 @@ dist/
 .DS_Store
 .env
 `;
-async function createPackage(packageName, options) {
+async function createPackage(packageName, options, output) {
   const resolvedName = expandTildePath(packageName);
   const packageDir = path5.isAbsolute(resolvedName) ? resolvedName : path5.join(process.cwd(), resolvedName);
   const packageSlug = path5.basename(resolvedName);
@@ -6341,115 +6340,134 @@ async function createPackage(packageName, options) {
     await fs9.writeFile(path5.join(packageDir, "README.md"), readmeTemplate(packageJsonName, registryPrefix, false));
     await fs9.writeFile(path5.join(packageDir, ".gitignore"), gitignoreTemplate);
   }
-  console.log(`Created new hostctl package '${resolvedName}' at ${packageDir}`);
-  console.log(`
-Next steps:`);
-  console.log(`1. cd ${packageDir}`);
-  console.log(`2. npm install`);
-  let step = 3;
+  const nextSteps = [];
+  nextSteps.push(`cd ${packageDir}`);
+  nextSteps.push("npm install");
   if (options.lang === "typescript") {
-    console.log(`${step}. Edit src/index.ts and src/tasks/hello.ts to implement your tasks`);
-    step += 1;
-    console.log(`${step}. npm run build`);
-    step += 1;
+    nextSteps.push("Edit src/index.ts and src/tasks/hello.ts to implement your tasks");
+    nextSteps.push("npm run build");
   } else {
-    console.log(`${step}. Edit src/index.js and src/tasks/hello.js to implement your tasks`);
-    step += 1;
+    nextSteps.push("Edit src/index.js and src/tasks/hello.js to implement your tasks");
   }
-  console.log(`${step}. Test your package with: hostctl tasks .`);
-  step += 1;
-  console.log(`${step}. Run it with: hostctl run . ${registryPrefix}.hello`);
-  console.log(`
+  nextSteps.push("Test your package with: hostctl tasks .");
+  nextSteps.push(`Run it with: hostctl run . ${registryPrefix}.hello`);
+  if (!output?.quiet) {
+    console.log(`Created new hostctl package '${resolvedName}' at ${packageDir}`);
+    console.log(`
+Next steps:`);
+    nextSteps.forEach((step, index) => {
+      console.log(`${index + 1}. ${step}`);
+    });
+    console.log(`
 Note: The package includes 'hostctl' as a dependency for local development.`);
-  console.log(`For production, you may want to add it as a peer dependency instead.`);
+    console.log(`For production, you may want to add it as a peer dependency instead.`);
+  }
+  return {
+    packageDir,
+    packageName: packageJsonName,
+    registryPrefix,
+    language: options.lang,
+    nextSteps
+  };
 }
 
 // src/commands/pkg/install.ts
-async function installPackage(source, app) {
+async function installPackage(source, app, output) {
   const packageManager = new PackageManager(app);
   const result = await packageManager.installPackage(source);
-  if (result.success) {
-    console.log(`Installed package '${result.packageInfo.name}' from ${source} to ${result.installPath}`);
-  } else {
-    console.error(`Failed to install package from ${source}: ${result.error}`);
-    throw new Error(result.error);
+  if (!output?.quiet) {
+    if (result.success) {
+      console.log(`Installed package '${result.packageInfo.name}' from ${source} to ${result.installPath}`);
+    } else {
+      console.error(`Failed to install package from ${source}: ${result.error}`);
+    }
   }
+  return { ...result, source };
 }
 
 // src/commands/pkg/list.ts
 import chalk5 from "chalk";
 async function listPackages(app) {
   const packageManager = new PackageManager(app);
-  try {
-    const packages = await packageManager.listPackages();
-    if (packages.length === 0) {
-      console.log("No packages installed.");
-      return;
+  const packages = await packageManager.listPackages();
+  const packagesByName = /* @__PURE__ */ new Map();
+  packages.forEach((pkg) => {
+    if (!packagesByName.has(pkg.name)) {
+      packagesByName.set(pkg.name, []);
     }
-    const packagesByName = /* @__PURE__ */ new Map();
-    packages.forEach((pkg) => {
-      if (!packagesByName.has(pkg.name)) {
-        packagesByName.set(pkg.name, []);
-      }
-      packagesByName.get(pkg.name).push(pkg);
-    });
-    console.log(`Found ${packages.length} package(s):
+    packagesByName.get(pkg.name).push(pkg);
+  });
+  const duplicateNames = Array.from(packagesByName.entries()).filter(([_, pkgs]) => pkgs.length > 1).map(([name]) => name);
+  return { packages, duplicateNames };
+}
+function printPackageList(packages, duplicateNames) {
+  if (packages.length === 0) {
+    console.log("No packages installed.");
+    return;
+  }
+  const packagesByName = /* @__PURE__ */ new Map();
+  packages.forEach((pkg) => {
+    if (!packagesByName.has(pkg.name)) {
+      packagesByName.set(pkg.name, []);
+    }
+    packagesByName.get(pkg.name).push(pkg);
+  });
+  console.log(`Found ${packages.length} package(s):
 `);
-    packages.forEach((pkg) => {
-      const packagesWithSameName = packagesByName.get(pkg.name);
-      const hasDuplicates = packagesWithSameName.length > 1;
-      let output = `\u2022 ${pkg.name}`;
-      if (pkg.version) {
-        output += ` (v${pkg.version})`;
-      }
-      if (pkg.description) {
-        output += ` - ${pkg.description}`;
-      }
-      if (hasDuplicates) {
-        output = chalk5.yellow(output);
-        output += chalk5.yellow(" \u26A0\uFE0F  (duplicate name)");
-      }
-      if (pkg.source) {
-        if (pkg.source.startsWith("http") || pkg.source.startsWith("git@")) {
-          output += `
+  packages.forEach((pkg) => {
+    const packagesWithSameName = packagesByName.get(pkg.name);
+    const hasDuplicates = packagesWithSameName.length > 1;
+    let output = `\u2022 ${pkg.name}`;
+    if (pkg.version) {
+      output += ` (v${pkg.version})`;
+    }
+    if (pkg.description) {
+      output += ` - ${pkg.description}`;
+    }
+    if (hasDuplicates) {
+      output = chalk5.yellow(output);
+      output += chalk5.yellow(" \u26A0\uFE0F  (duplicate name)");
+    }
+    if (pkg.source) {
+      if (pkg.source.startsWith("http") || pkg.source.startsWith("git@")) {
+        output += `
   \u{1F4E6} Source: ${pkg.source}`;
-        } else if (!pkg.source.startsWith(".") && !pkg.source.startsWith("/")) {
-          output += `
+      } else if (!pkg.source.startsWith(".") && !pkg.source.startsWith("/")) {
+        output += `
   \u{1F4E6} Source: https://www.npmjs.com/package/${pkg.source}`;
-        } else {
-          output += `
+      } else {
+        output += `
   \u{1F4E6} Source: ${pkg.source}`;
-        }
       }
-      console.log(output);
-      console.log(`  \u2514\u2500 (run "hostctl tasks ${pkg.name}" to list tasks)`);
-      console.log("");
-    });
-    const duplicateNames = Array.from(packagesByName.entries()).filter(([_, pkgs]) => pkgs.length > 1).map(([name, _]) => name);
-    if (duplicateNames.length > 0) {
-      console.log(chalk5.yellow("\u26A0\uFE0F  Warning: The following package names have duplicates:"));
-      duplicateNames.forEach((name) => {
-        console.log(chalk5.yellow(`   - ${name}`));
-      });
-      console.log(chalk5.yellow("   Use the full source URL to run tasks from these packages."));
-      console.log("");
     }
-  } catch (error) {
-    console.error("Error listing packages:", error);
-    throw error;
+    console.log(output);
+    console.log(`  \u2514\u2500 (run "hostctl tasks ${pkg.name}" to list tasks)`);
+    console.log("");
+  });
+  if (duplicateNames.length > 0) {
+    console.log(chalk5.yellow("\u26A0\uFE0F  Warning: The following package names have duplicates:"));
+    duplicateNames.forEach((name) => {
+      console.log(chalk5.yellow(`   - ${name}`));
+    });
+    console.log(chalk5.yellow("   Use the full source URL to run tasks from these packages."));
+    console.log("");
   }
 }
 
 // src/commands/pkg/remove.ts
-async function removePackage(packageIdentifier, app) {
+async function removePackage(packageIdentifier, app, output) {
   const packageManager = new PackageManager(app);
   const result = await packageManager.removePackage(packageIdentifier);
-  if (result.success && result.packageInfo) {
-    console.log(`Successfully removed package '${result.packageInfo.name}' (${result.packageInfo.directory})`);
-  } else {
-    console.error(`Failed to remove package: ${result.error}`);
-    return;
+  if (!output?.quiet) {
+    if (result.success && result.packageInfo) {
+      console.log(`Successfully removed package '${result.packageInfo.name}' (${result.packageInfo.directory})`);
+    } else if (result.success && result.warning) {
+      console.warn(result.warning);
+    } else {
+      console.error(`Failed to remove package: ${result.error}`);
+    }
   }
+  return result;
 }
 
 // src/cli.ts
@@ -6779,8 +6797,6 @@ var Cli = class {
       '-p, --params "<json object>"',
       "runtime parameters supplied as a string to be parsed as a json object representing params to supply to the script"
     ).option("-r, --remote", "run the script on remote hosts specified by tags via SSH orchestration").action(this.handleRun.bind(this));
-    const runtimeCmd = this.program.command("runtime").alias("rt").description("print out a report of the runtime environment").action(this.handleRuntime.bind(this));
-    runtimeCmd.command("install").alias("i").description("install a temporary runtime environment on the local host if needed").action(this.handleRuntimeInstall.bind(this));
     this.program.command("tasks").description("list tasks available in a package or path").argument("[package-or-path...]", "npm package spec, installed package name, or local path").option("--task <name>", "filter to a specific task name").option("--json", "output should be json formatted").action(this.handleTasksList.bind(this));
   }
   async handleInventory(options, cmd) {
@@ -6960,37 +6976,87 @@ var Cli = class {
       logError("hostctl error:", e);
     }
   }
-  async handleRuntime(options, cmd) {
-    const opts = cmd.optsWithGlobals();
-    await this.loadApp(opts);
-    await this.app.printRuntimeReport();
-  }
-  async handleRuntimeInstall(options, cmd) {
-    const opts = cmd.optsWithGlobals();
-    await this.loadApp(opts);
-    await this.app.installRuntime();
-  }
   async handlePkgCreate(packageName, options) {
+    const opts = this.program.opts();
+    if (opts.json) {
+      try {
+        const result = await createPackage(packageName, options, { quiet: true });
+        console.log(JSON.stringify({ success: true, ...result }, null, 2));
+      } catch (error) {
+        console.log(
+          JSON.stringify({ success: false, error: error instanceof Error ? error.message : String(error) }, null, 2)
+        );
+        process4.exitCode = 1;
+      }
+      return;
+    }
     await createPackage(packageName, options);
   }
   async handlePkgInstall(source) {
-    await this.loadApp(this.program.opts());
-    try {
-      await installPackage(source, this.app);
-    } catch (error) {
-      console.error(
-        `Failed to install package from ${source}: ${error instanceof Error ? error.message : String(error)}`
+    const opts = this.program.opts();
+    await this.loadApp(opts);
+    const result = await installPackage(source, this.app, { quiet: Boolean(opts.json) });
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            success: result.success,
+            source: result.source,
+            package: result.packageInfo,
+            installPath: result.installPath,
+            error: result.error
+          },
+          null,
+          2
+        )
       );
+    }
+    if (!result.success) {
       process4.exitCode = 1;
     }
   }
   async handlePkgList() {
-    await this.loadApp(this.program.opts());
-    await listPackages(this.app);
+    const opts = this.program.opts();
+    await this.loadApp(opts);
+    const result = await listPackages(this.app);
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            count: result.packages.length,
+            duplicates: result.duplicateNames,
+            packages: result.packages
+          },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    printPackageList(result.packages, result.duplicateNames);
   }
   async handlePkgRemove(packageIdentifier) {
-    await this.loadApp(this.program.opts());
-    await removePackage(packageIdentifier, this.app);
+    const opts = this.program.opts();
+    await this.loadApp(opts);
+    const result = await removePackage(packageIdentifier, this.app, { quiet: Boolean(opts.json) });
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          {
+            success: result.success,
+            identifier: packageIdentifier,
+            package: result.packageInfo,
+            error: result.error,
+            warning: result.warning
+          },
+          null,
+          2
+        )
+      );
+    }
+    if (!result.success) {
+      process4.exitCode = 1;
+    }
   }
   async handleTasksList(specParts, options, cmd) {
     const opts = cmd.optsWithGlobals();