hostctl 0.1.48 → 0.1.49

package/README.md

@@ -138,6 +138,29 @@ hostctl pkg remove hostctl-hello
 Installed packages live under `~/.hostctl/packages` and can be run offline once cached.
 Use `pkg install` for npm registry names (scoped + versioned) or git URLs. Local directories should be run directly without installing (`hostctl run ./path/to/pkg task args`); this avoids polluting the manifest with workstation paths and keeps the install story aligned with reproducible npm/git sources.
 
+Add `--json` to any `hostctl pkg` command for machine-readable output:
+
+```bash
+hostctl pkg list --json
+```
+
+```json
+{
+  "count": 1,
+  "duplicates": [],
+  "packages": [
+    {
+      "name": "hostctl-hello",
+      "version": "1.2.3",
+      "description": "Example tasks",
+      "directory": "hostctl-hello",
+      "source": "https://github.com/monopod/hostctl-example",
+      "path": "/home/you/.hostctl/packages/hostctl-hello"
+    }
+  ]
+}
+```
+
 ## Designing tasks
 
 Define tasks with the `task` helper and a typed `TaskContext`:

package/dist/bin/hostctl.js

@@ -3975,7 +3975,7 @@ var ParamMap = class _ParamMap {
 import * as z from "zod";
 
 // src/version.ts
-var version = "0.1.48";
+var version = "0.1.49";
 
 // src/app.ts
 import { retryUntilDefined } from "ts-retry";
@@ -4298,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" };
     }
   }
@@ -4457,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);
@@ -4490,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}`);
+      }
     }
   }
   /**
@@ -4549,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,
@@ -4653,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());
@@ -4694,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:`);
@@ -6306,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);
@@ -6329,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
@@ -6947,26 +6977,86 @@ var Cli = class {
     }
   }
   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();