hostctl 0.1.47 → 0.1.48

package/README.md

@@ -206,7 +206,6 @@ Key `TaskContext` capabilities (see [`docs/task-api.md`](docs/task-api.md) for d
 - **Version mismatch**: keep `package.json`, `src/version.ts`, and `jsr.json` in sync before releasing.
 - **SSH failures**: verify inventory entries (hostname, user, auth) and only pass `-r` when you intend remote execution.
 - **Secrets**: when inventories are encrypted, ensure `AGE_IDS` includes the private keys so `hostctl` can decrypt secrets.
-- **Environment drift**: run `hostctl runtime` to inspect prerequisites or `hostctl runtime install` to bootstrap them.
 
 ## Developer workflow
 

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.48";
+
+// 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) {
@@ -6023,15 +6025,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 +6043,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
    *
@@ -6779,8 +6767,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,16 +6946,6 @@ 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) {
     await createPackage(packageName, options);
   }