omkit 0.1.0 → 0.1.2

package/dist/actions/command.d.ts

@@ -7,9 +7,21 @@ export interface CommandOptions {
     /** Let this command inherit the orchestrator's debugger (default false). */
     inheritDebugger?: boolean;
 }
+declare function build(name: string, cmdOrFile: string, argsOrOptions: readonly string[] | CommandOptions, maybeOptions: CommandOptions): import("../index.ts").ActionInstance<import("zx").ProcessOutput, import("../core/types.ts").NoEvents, void>;
 /**
- * Runs a fixed shell command as an action instance. Output streams into the run's
- * log under `name`; a non-zero exit fails the action; teardown kills the child.
- * For interpolated args, events, or a daemon loop, drop to `action(...).run(...)`.
+ * Runs a shell command as an action instance. Two forms:
+ *
+ * - `command(name, cmd, options?)` — a full command **string**, run verbatim through the
+ *   shell, so pipes, globs and `&&` work (quote anything yourself).
+ * - `command(name, file, args, options?)` — an executable **plus an args array**; each arg
+ *   is quoted individually, so spaces and `=`/paths in args are safe without hand-quoting.
+ *
+ * Output streams into the run's log under `name`; a non-zero exit fails the action;
+ * teardown kills the child tree. For interpolated events or a daemon loop, drop to
+ * `action(...).run(...)`.
  */
-export declare function command(name: string, cmd: string, options?: CommandOptions): import("../index.ts").ActionInstance<import("zx").ProcessOutput, import("../core/types.ts").NoEvents, void>;
+export declare const command: {
+    (name: string, cmd: string, options?: CommandOptions): ReturnType<typeof build>;
+    (name: string, file: string, args: readonly string[], options?: CommandOptions): ReturnType<typeof build>;
+};
+export {};

package/dist/actions/command.js

@@ -6,18 +6,33 @@ import { action } from "../core/action.js";
  * `pieces` runs exactly as written (pipes, globs, `&&`).
  */
 const verbatim = (cmd) => Object.assign([cmd], { raw: [cmd] });
-/**
- * Runs a fixed shell command as an action instance. Output streams into the run's
- * log under `name`; a non-zero exit fails the action; teardown kills the child.
- * For interpolated args, events, or a daemon loop, drop to `action(...).run(...)`.
- */
-export function command(name, cmd, options = {}) {
+function build(name, cmdOrFile, argsOrOptions, maybeOptions) {
+    const hasArgs = Array.isArray(argsOrOptions);
+    const args = hasArgs ? argsOrOptions : undefined;
+    const options = (hasArgs ? maybeOptions : argsOrOptions) ?? {};
     return action(name).run((ctx) => {
         const cwd = path.resolve(options.cwd ?? ".");
-        return ctx.proc(name, {
+        const proc = ctx.proc(name, {
             cwd,
             ...(options.env ? { env: options.env } : {}),
             ...(options.inheritDebugger ? { inheritDebugger: true } : {}),
-        })(verbatim(cmd));
+        });
+        // `file, args` form: zx quotes the file and every arg individually (arrays spread), so
+        // paths/values with spaces are safe and nothing is re-parsed by the shell. String form:
+        // run the whole command verbatim.
+        return args ? proc `${cmdOrFile} -- ${args}` : proc(verbatim(cmdOrFile));
     })();
 }
+/**
+ * Runs a shell command as an action instance. Two forms:
+ *
+ * - `command(name, cmd, options?)` — a full command **string**, run verbatim through the
+ *   shell, so pipes, globs and `&&` work (quote anything yourself).
+ * - `command(name, file, args, options?)` — an executable **plus an args array**; each arg
+ *   is quoted individually, so spaces and `=`/paths in args are safe without hand-quoting.
+ *
+ * Output streams into the run's log under `name`; a non-zero exit fails the action;
+ * teardown kills the child tree. For interpolated events or a daemon loop, drop to
+ * `action(...).run(...)`.
+ */
+export const command = (name, cmdOrFile, argsOrOptions = {}, maybeOptions = {}) => build(name, cmdOrFile, argsOrOptions, maybeOptions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omkit",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A tiny runtime for developer workflows: typed actions that pass runtime capabilities and emit typed events, under one run and one shared log. The operational/runtime layer to tskb's knowledge layer.",
   "type": "module",
   "main": "./dist/index.js",