hostctl 0.1.47 → 0.1.49

package/dist/index.d.ts

@@ -841,9 +841,7 @@ declare class App {
     private resolveTaskFnFromModule;
     parseParams(scriptArgs: string[]): Object;
     pathOfPackageJsonFile(path: string): Path | null;
-    printRuntimeReport(): Promise<void>;
     promptPasswordInteractively(message?: string): Promise<string>;
-    installRuntime(): Promise<void>;
     /**
      * Executes a command on the selected hosts
      *
@@ -892,8 +890,6 @@ declare class Cli {
     deriveConfigRef(suppliedConfigRef?: string): string;
     loadApp(opts: Record<string, any>): Promise<void>;
     run(): Promise<void>;
-    handleRuntime(options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
-    handleRuntimeInstall(options: Record<string, any>, cmd: cmdr.Command): Promise<void>;
     handlePkgCreate(packageName: string, options: {
         lang: 'typescript' | 'javascript';
     }): Promise<void>;

package/dist/index.js

@@ -2718,7 +2718,7 @@ var Verbosity = {
 };
 
 // src/version.ts
-var version = "0.1.47";
+var version = "0.1.49";
 
 // src/commands/pkg/create.ts
 import { promises as fs5 } from "fs";
@@ -2942,7 +2942,7 @@ dist/
 .DS_Store
 .env
 `;
-async function createPackage(packageName, options) {
+async function createPackage(packageName, options, output) {
   const resolvedName = expandTildePath(packageName);
   const packageDir = path3.isAbsolute(resolvedName) ? resolvedName : path3.join(process.cwd(), resolvedName);
   const packageSlug = path3.basename(resolvedName);
@@ -2965,27 +2965,35 @@ async function createPackage(packageName, options) {
     await fs5.writeFile(path3.join(packageDir, "README.md"), readmeTemplate(packageJsonName, registryPrefix, false));
     await fs5.writeFile(path3.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/package-manager.ts
@@ -3469,7 +3477,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" };
     }
   }
@@ -3628,8 +3638,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);
@@ -3661,7 +3671,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}`);
+      }
     }
   }
   /**
@@ -3720,7 +3732,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,
@@ -3824,7 +3838,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());
@@ -3865,6 +3881,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:`);
@@ -3907,91 +3926,102 @@ var PackageManager = class {
 };
 
 // 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 chalk 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 = chalk.yellow(output);
-        output += chalk.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 = chalk.yellow(output);
+      output += chalk.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(chalk.yellow("\u26A0\uFE0F  Warning: The following package names have duplicates:"));
-      duplicateNames.forEach((name) => {
-        console.log(chalk.yellow(`   - ${name}`));
-      });
-      console.log(chalk.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(chalk.yellow("\u26A0\uFE0F  Warning: The following package names have duplicates:"));
+    duplicateNames.forEach((name) => {
+      console.log(chalk.yellow(`   - ${name}`));
+    });
+    console.log(chalk.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
@@ -4630,8 +4660,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) {
@@ -4811,37 +4839,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)
+        );
+        process3.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) {
       process3.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) {
+      process3.exitCode = 1;
+    }
   }
   async handleTasksList(specParts, options, cmd) {
     const opts = cmd.optsWithGlobals();
@@ -7082,15 +7160,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;
@@ -7109,11 +7178,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
    *