@haltcase/run 1.0.0

package/dist/cli/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createHandler } from "./handler.js";
+import { main } from "./main.js";
+const handler = createHandler();
+void main({
+    handler
+});
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAEhC,KAAK,IAAI,CAAC;IACT,OAAO;CACP,CAAC,CAAC"}

package/dist/cli/handler.d.ts

@@ -0,0 +1,22 @@
+import { Spinner } from "@favware/colorette-spinner";
+import type { MainContextWithData } from "./main.js";
+export declare const failWith: (spinner: Spinner, message: unknown) => never;
+export declare const write: (message: string) => void;
+interface HelpContextCommand {
+    command: string;
+}
+interface HelpContextScript extends MainContextWithData {
+    taskList: true;
+}
+type HelpContext = HelpContextCommand | HelpContextScript;
+export declare const commandHandler: (_context: HelpContextCommand) => string;
+export declare const taskListHandler: (context: HelpContextScript) => string;
+export declare const help: (context: HelpContext) => string;
+export interface Handler {
+    spinner: Spinner;
+    help: (context: HelpContext) => string;
+    write: (message: string) => void;
+    failWith: (message: unknown) => never;
+}
+export declare const createHandler: () => Handler;
+export {};

package/dist/cli/handler.js

@@ -0,0 +1,79 @@
+import { Spinner } from "@favware/colorette-spinner";
+import cliui from "@isaacs/cliui";
+import { bold, yellow } from "colorette";
+import { isBrandedTask } from "../tasks/guards.js";
+export const failWith = (spinner, message) => {
+    let text;
+    if (Array.isArray(message)) {
+        text = message.map(String).join("\n");
+    }
+    if (text == null || typeof text !== "string") {
+        text = String(message);
+    }
+    spinner.error({
+        text
+    });
+    process.exit(1);
+};
+export const write = (message) => {
+    process.stdout.write(`${message}\n`);
+};
+const usage = `Usage: ${yellow("hr")} <action> [task]`;
+export const commandHandler = (_context) => {
+    return usage;
+};
+export const taskListHandler = (context) => {
+    const ui = cliui({
+        width: Math.max(0, process.stdout.columns - 4),
+        wrap: true
+    });
+    const { config } = context.taskFile.data;
+    const taskInfo = Object.entries(config)
+        .map(([name, value]) => {
+        if (!value) {
+            return "";
+        }
+        const formattedName = bold(name);
+        if (isBrandedTask(value)) {
+            if (value.kind === "strictTask") {
+                const keys = Object.keys(value.inputSchema).join(", ");
+                const { description = "" } = value.schema;
+                return [formattedName, keys && `{ ${keys} }`, description]
+                    .filter(Boolean)
+                    .join("\t");
+            }
+            return formattedName;
+        }
+        return formattedName;
+    })
+        .join("\n");
+    ui.div(usage.replace("<action>", context.taskFile.name));
+    ui.div({
+        text: "Available tasks:",
+        padding: [1, 0, 1, 0]
+    });
+    ui.div({
+        text: taskInfo,
+        padding: [0, 2, 1, 2]
+    });
+    return ui.toString();
+};
+export const help = (context) => {
+    if ("command" in context) {
+        return commandHandler(context);
+    }
+    if ("taskList" in context) {
+        return taskListHandler(context);
+    }
+    return "";
+};
+export const createHandler = () => {
+    const spinner = new Spinner();
+    return {
+        spinner,
+        help,
+        write,
+        failWith: (message) => failWith(spinner, message)
+    };
+};
+//# sourceMappingURL=handler.js.map

package/dist/cli/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/cli/handler.ts"],"names":[],"mappings":"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"}

package/dist/cli/handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/handler.test.js

@@ -0,0 +1,23 @@
+import { expect, test, vi } from "vitest";
+import { createHandler } from "./handler.js";
+const handler = createHandler();
+const stdoutSpy = vi.spyOn(globalThis.process.stdout, "write");
+const stderrSpy = vi.spyOn(globalThis.process.stderr, "write");
+const exitSpy = vi.spyOn(globalThis.process, "exit");
+test("handler: writes to stdout", () => {
+    const stdout = stdoutSpy.mockImplementationOnce(() => true);
+    const message = "Success";
+    handler.write(message);
+    expect(stdout).toHaveBeenCalledWith(`${message}\n`);
+});
+test("handler: writes to stderr and exits", () => {
+    const stderr = stderrSpy.mockImplementationOnce(() => true);
+    // @ts-expect-error we can't actually return never
+    const exit = exitSpy.mockImplementationOnce(() => {
+        // nothing
+    });
+    handler.failWith("Error message");
+    expect(stderr).toHaveBeenCalled();
+    expect(exit).toHaveBeenCalled();
+});
+//# sourceMappingURL=handler.test.js.map

package/dist/cli/handler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.test.js","sourceRoot":"","sources":["../../src/cli/handler.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;AAEhC,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/D,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/D,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAErD,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE;IAChD,MAAM,MAAM,GAAG,SAAS,CAAC,sBAAsB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC5D,kDAAkD;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,sBAAsB,CAAC,GAAG,EAAE;QAChD,UAAU;IACX,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAElC,MAAM,CAAC,MAAM,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,CAAC;AACjC,CAAC,CAAC,CAAC"}

package/dist/cli/main.d.ts

@@ -0,0 +1,21 @@
+import type { ParsedPath } from "node:path";
+import type { AppConfig } from "../config.js";
+import type { TaskCollection } from "../tasks/types.js";
+import type { ResolvedConfigWithFile } from "../util/loadTaskFile.js";
+import type { Handler } from "./handler.js";
+export interface MainProps {
+    handler: Handler;
+}
+export interface MainContext extends MainProps {
+    config: AppConfig;
+    taskFile: ParsedPath & {
+        path: string;
+    };
+    taskName: string;
+}
+export interface MainContextWithData extends MainContext {
+    taskFile: MainContext["taskFile"] & {
+        data: ResolvedConfigWithFile<TaskCollection>;
+    };
+}
+export declare const main: (props: MainProps) => Promise<void>;

package/dist/cli/main.js

@@ -0,0 +1,57 @@
+import { parse, resolve } from "node:path";
+import { getAppConfig } from "../config.js";
+import { executeTask } from "../tasks/executeTask.js";
+import { loadTaskFile } from "../util/loadTaskFile.js";
+import { resolveTaskFile } from "../util/resolveTaskFile.js";
+import { parseOptions } from "./parseOptions.js";
+export const main = async (props) => {
+    const { config } = await getAppConfig();
+    const inputFileName = process.argv[2];
+    const taskName = process.argv[3] ?? "";
+    if (!inputFileName) {
+        props.handler.help({ command: "help" });
+        props.handler.failWith("Task file name is required");
+    }
+    const fullFilePath = resolve(config.taskDirectory, inputFileName);
+    const context = {
+        ...props,
+        config,
+        taskFile: {
+            ...parse(fullFilePath),
+            path: fullFilePath
+        },
+        taskName
+    };
+    const resolutions = resolveTaskFile(context);
+    if (Array.isArray(resolutions)) {
+        props.handler.failWith([
+            `Found multiple task files with the name '${context.taskFile.name}'`,
+            `Rename the ambiguous files or specify an extension and try again`,
+            resolutions.map((it) => `  ${it}`).join("\n")
+        ]);
+    }
+    const taskFileResult = await loadTaskFile(context);
+    if (!taskFileResult.ok) {
+        props.handler.failWith(taskFileResult.error);
+    }
+    const contextWithData = {
+        ...context,
+        taskFile: {
+            ...context.taskFile,
+            data: taskFileResult.value
+        }
+    };
+    try {
+        const options = parseOptions(process.argv.slice(4));
+        await executeTask(contextWithData, options);
+        if (!config.quiet) {
+            props.handler.spinner.success({
+                text: "Success"
+            });
+        }
+    }
+    catch (error) {
+        props.handler.failWith([`Failed to execute task`, String(error)]);
+    }
+};
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAoBjD,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAgB,EAAE,EAAE;IAC9C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,EAAE,CAAC;IAExC,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG;QACf,GAAG,KAAK;QACR,MAAM;QACN,QAAQ,EAAE;YACT,GAAG,KAAK,CAAC,YAAY,CAAC;YACtB,IAAI,EAAE,YAAY;SAClB;QACD,QAAQ;KACc,CAAC;IAExB,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YACtB,4CAA4C,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG;YACpE,kEAAkE;YAClE,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;SAC7C,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,eAAe,GAAG;QACvB,GAAG,OAAO;QACV,QAAQ,EAAE;YACT,GAAG,OAAO,CAAC,QAAQ;YACnB,IAAI,EAAE,cAAc,CAAC,KAAK;SAC1B;KAC6B,CAAC;IAEhC,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,MAAM,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAE5C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACnB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;gBAC7B,IAAI,EAAE,SAAS;aACf,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,wBAAwB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;AACF,CAAC,CAAC"}

package/dist/cli/parseOptions.d.ts

@@ -0,0 +1,12 @@
+export interface ParsedOptions {
+    _: string[];
+    [key: string]: unknown;
+}
+/**
+ * Wrapper around Node's {@link parseArgs} that treats options as strings
+ * by default, instead of boolean flags.
+ *
+ * @param args - argv-like string
+ * @returns
+ */
+export declare const parseOptions: (args: string[]) => ParsedOptions;

package/dist/cli/parseOptions.js

@@ -0,0 +1,45 @@
+import { parseArgs } from "node:util";
+/**
+ * Wrapper around Node's {@link parseArgs} that treats options as strings
+ * by default, instead of boolean flags.
+ *
+ * @param args - argv-like string
+ * @returns
+ */
+export const parseOptions = (args) => {
+    const { tokens } = parseArgs({
+        args,
+        allowPositionals: true,
+        strict: false,
+        tokens: true
+    });
+    const options = {
+        _: []
+    };
+    for (let index = 0; index < tokens.length; index++) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        const token = tokens[index];
+        if (token.kind === "option-terminator") {
+            continue;
+        }
+        if (token.kind === "option") {
+            if (index + 1 < tokens.length) {
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                const next = tokens[index + 1];
+                if (next.kind !== "positional") {
+                    throw new Error(`Expected value for option ${token.rawName}`);
+                }
+                options[token.name] = next.value;
+                index++;
+            }
+            else {
+                throw new Error(`Expected option ${token.rawName} to be followed by a value`);
+            }
+        }
+        if (token.kind === "positional") {
+            options._.push(token.value);
+        }
+    }
+    return options;
+};
+//# sourceMappingURL=parseOptions.js.map

package/dist/cli/parseOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOptions.js","sourceRoot":"","sources":["../../src/cli/parseOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAOtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAc,EAAiB,EAAE;IAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC5B,IAAI;QACJ,gBAAgB,EAAE,IAAI;QACtB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,IAAI;KACZ,CAAC,CAAC;IAEH,MAAM,OAAO,GAAkB;QAC9B,CAAC,EAAE,EAAE;KACL,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,oEAAoE;QACpE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACxC,SAAS;QACV,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC/B,oEAAoE;gBACpE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;gBAEhC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC/D,CAAC;gBAED,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;gBACjC,KAAK,EAAE,CAAC;YACT,CAAC;iBAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACd,mBAAmB,KAAK,CAAC,OAAO,4BAA4B,CAC5D,CAAC;YACH,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC"}

package/dist/cli/parseOptions.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/parseOptions.test.js

@@ -0,0 +1,35 @@
+import { expect, test } from "vitest";
+import { parseOptions } from "./parseOptions.js";
+test("parseOptions: parses options as key/value and returns positionals", () => {
+    expect(parseOptions([
+        "--file",
+        "readme.md",
+        "--dryRun",
+        "true",
+        "you",
+        "spin",
+        "me",
+        "right",
+        "round"
+    ])).toStrictEqual({
+        _: ["you", "spin", "me", "right", "round"],
+        file: "readme.md",
+        dryRun: "true"
+    });
+});
+test("parseOptions: expects all options to have values", () => {
+    expect(() => parseOptions(["--name"])).toThrow("Expected option --name to be followed by a value");
+});
+test("parseOptions: returns everything after terminator as positionals", () => {
+    expect(parseOptions(["--color", "blue", "--", "--name", "-aBcDeF"]))
+        .toMatchInlineSnapshot(`
+		{
+		  "_": [
+		    "--name",
+		    "-aBcDeF",
+		  ],
+		  "color": "blue",
+		}
+	`);
+});
+//# sourceMappingURL=parseOptions.test.js.map

package/dist/cli/parseOptions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseOptions.test.js","sourceRoot":"","sources":["../../src/cli/parseOptions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,IAAI,CAAC,mEAAmE,EAAE,GAAG,EAAE;IAC9E,MAAM,CACL,YAAY,CAAC;QACZ,QAAQ;QACR,WAAW;QACX,UAAU;QACV,MAAM;QACN,KAAK;QACL,MAAM;QACN,IAAI;QACJ,OAAO;QACP,OAAO;KACP,CAAC,CACF,CAAC,aAAa,CAAC;QACf,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;QAC1C,IAAI,EAAE,WAAW;QACjB,MAAM,EAAE,MAAM;KACd,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,GAAG,EAAE;IAC7D,MAAM,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAC7C,kDAAkD,CAClD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC7E,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;SAClE,qBAAqB,CAAC;;;;;;;;EAQvB,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/cli/util.d.ts

@@ -0,0 +1,15 @@
+import type { ResultError } from "../util/result.js";
+import type { MainContextWithData } from "./main.js";
+export declare const failWith: (message: unknown) => ResultError<Error>;
+export declare const write: (message: string) => void;
+interface HelpContextCommand {
+    command: string;
+}
+interface HelpContextScript extends MainContextWithData {
+    taskList: true;
+}
+type HelpContext = HelpContextCommand | HelpContextScript;
+export declare const commandHandler: (_context: HelpContextCommand) => string;
+export declare const taskListHandler: (context: HelpContextScript) => string;
+export declare const help: (context: HelpContext) => string;
+export {};

package/dist/cli/util.js

@@ -0,0 +1,68 @@
+import cliui from "@isaacs/cliui";
+import { bold, yellow } from "colorette";
+import { isBrandedTask } from "../tasks/guards.js";
+export const failWith = (message) => {
+    let text;
+    if (Array.isArray(message)) {
+        text = message.map(String).join("\n");
+    }
+    if (text == null || typeof text !== "string") {
+        text = String(message);
+    }
+    return {
+        ok: false,
+        error: new Error(text)
+    };
+};
+export const write = (message) => {
+    process.stdout.write(`${message}\n`);
+};
+const usage = `Usage: ${yellow("funtask")} <action> [task]`;
+export const commandHandler = (_context) => {
+    return usage;
+};
+export const taskListHandler = (context) => {
+    const ui = cliui({
+        width: Math.max(0, process.stdout.columns - 4),
+        wrap: true
+    });
+    const { config } = context.taskFile.data;
+    const taskInfo = Object.entries(config)
+        .map(([name, value]) => {
+        if (!value) {
+            return "";
+        }
+        const formattedName = bold(name);
+        if (isBrandedTask(value)) {
+            if (value.kind === "strictTask") {
+                const keys = Object.keys(value.inputSchema).join(", ");
+                const { description = "" } = value.schema;
+                return [formattedName, keys && `{ ${keys} }`, description]
+                    .filter(Boolean)
+                    .join("\t");
+            }
+            return formattedName;
+        }
+        return formattedName;
+    })
+        .join("\n");
+    ui.div(usage.replace("<action>", context.taskFile.name));
+    ui.div({
+        text: "Available tasks:",
+        padding: [1, 0, 1, 0]
+    });
+    ui.div({
+        text: taskInfo,
+        padding: [0, 2, 1, 2]
+    });
+    return ui.toString();
+};
+export const help = (context) => {
+    if ("command" in context) {
+        return commandHandler(context);
+    }
+    if ("taskList" in context) {
+        return taskListHandler(context);
+    }
+    return "";
+};

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+export interface AppConfig {
+    /**
+     * Directory containing task files. Defaults to the `scripts` folder within
+     * the current working directory.
+     *
+     * @default `<cwd>/scripts`
+     */
+    taskDirectory: string;
+    /**
+     * Print no output unless errors occur.
+     *
+     * @default false
+     */
+    quiet: boolean;
+}
+export declare const getAppConfig: () => Promise<import("c12").ResolvedConfig<AppConfig, import("c12").ConfigLayerMeta>>;

package/dist/config.js

@@ -0,0 +1,17 @@
+import { join } from "node:path";
+import { cwd } from "node:process";
+import { loadConfig } from "c12";
+export const getAppConfig = async () => {
+    const configName = "haltcase.run";
+    return loadConfig({
+        name: configName,
+        configFile: configName,
+        packageJson: configName,
+        rcFile: configName,
+        defaults: {
+            taskDirectory: join(cwd(), "scripts"),
+            quiet: false
+        }
+    });
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAmBjC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;IACtC,MAAM,UAAU,GAAG,cAAc,CAAC;IAElC,OAAO,UAAU,CAAY;QAC5B,IAAI,EAAE,UAAU;QAChB,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,UAAU;QACvB,MAAM,EAAE,UAAU;QAElB,QAAQ,EAAE;YACT,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC;YACrC,KAAK,EAAE,KAAK;SACZ;KACD,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { ParsedOptions } from "./cli/parseOptions.js";
+export type { AppConfig as HaltcaseRunConfig } from "./config.js";
+export { task } from "./tasks/task.js";
+export type { Task } from "./tasks/types.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { task } from "./tasks/task.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tasks/executeTask.d.ts

@@ -0,0 +1,12 @@
+import type { MainContextWithData } from "../cli/main.js";
+import type { ParsedOptions } from "../cli/parseOptions.js";
+export declare const taskUtilities: {
+    command: import("execa").ExecaMethod<{}>;
+    $: import("execa").ExecaScriptMethod<{}>;
+    exec: import("execa").ExecaMethod<{
+        stdin: "inherit";
+        stdout: "inherit";
+        stderr: "inherit";
+    }>;
+};
+export declare const executeTask: (context: MainContextWithData, options: ParsedOptions) => Promise<void>;

package/dist/tasks/executeTask.js

@@ -0,0 +1,43 @@
+import { join } from "node:path";
+import { $, execa } from "execa";
+const execaInherited = execa({
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit"
+});
+export const taskUtilities = {
+    command: execa,
+    $,
+    exec: execaInherited
+};
+export const executeTask = async (context, options) => {
+    const taskFunction = context.taskFile.data.config[context.taskName];
+    const specifier = `${context.taskFile.name}::${context.taskName}`;
+    if (taskFunction == null) {
+        context.handler.write(context.handler.help({
+            taskList: true,
+            ...context
+        }));
+        if (!context.taskName) {
+            context.handler.failWith(`Task name is required.`);
+        }
+        context.handler.failWith([
+            `Task file '${context.taskFile.base}' does not export '${context.taskName}'`,
+            `Resolved to: ${join(context.taskFile.dir, context.taskFile.base)}`
+        ]);
+    }
+    try {
+        await taskFunction(options, taskUtilities);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes("is not a function")) {
+            context.handler.failWith([
+                `Failed to execute ${specifier}`,
+                `Exported value '${context.taskName}' is not a function`
+            ]);
+        }
+        context.handler.failWith([`Failed to execute ${specifier}`, message]);
+    }
+};
+//# sourceMappingURL=executeTask.js.map

package/dist/tasks/executeTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeTask.js","sourceRoot":"","sources":["../../src/tasks/executeTask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAMjC,MAAM,cAAc,GAAG,KAAK,CAAC;IAC5B,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CACjB,CAAiC,CAAC;AAEnC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC5B,OAAO,EAAE,KAAK;IACd,CAAC;IACD,IAAI,EAAE,cAAc;CACI,CAAC;AAE1B,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC/B,OAA4B,EAC5B,OAAsB,EACrB,EAAE;IACH,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;IAElE,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,KAAK,CACpB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACpB,QAAQ,EAAE,IAAI;YACd,GAAG,OAAO;SACV,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACvB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxB,cAAc,OAAO,CAAC,QAAQ,CAAC,IAAI,sBAAsB,OAAO,CAAC,QAAQ,GAAG;YAC5E,gBAAgB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;SACnE,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,YAAY,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEvE,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;gBACxB,qBAAqB,SAAS,EAAE;gBAChC,mBAAmB,OAAO,CAAC,QAAQ,qBAAqB;aACxD,CAAC,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,qBAAqB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IACvE,CAAC;AACF,CAAC,CAAC"}

package/dist/tasks/guards.d.ts

@@ -0,0 +1,3 @@
+import type { BrandedTask, BrandedTaskStrict, Task } from "./types.js";
+export declare const isBrandedTask: (task: Task) => task is BrandedTask;
+export declare const isBrandedTaskStrict: (task: Task) => task is BrandedTaskStrict;

package/dist/tasks/guards.js

@@ -0,0 +1,3 @@
+export const isBrandedTask = (task) => "kind" in task;
+export const isBrandedTaskStrict = (task) => "kind" in task && task.kind === "strictTask";
+//# sourceMappingURL=guards.js.map

package/dist/tasks/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/tasks/guards.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAU,EAAuB,EAAE,CAChE,MAAM,IAAI,IAAI,CAAC;AAEhB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAU,EAA6B,EAAE,CAC5E,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC"}

package/dist/tasks/task.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { ParsedOptions } from "../cli/parseOptions.js";
+import type { BrandedTask, ExpectShape, Task } from "./types.js";
+export declare const task: {
+    <T = ParsedOptions>(fn: Task<T>): BrandedTask<T>;
+    strict<TShape extends ExpectShape, TSchema extends z.ZodObject<TShape> = z.ZodObject<TShape, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<TShape>, any> extends infer T ? { [k in keyof T]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<TShape>, any>[k]; } : never, z.baseObjectInputType<TShape> extends infer T_1 ? { [k_1 in keyof T_1]: z.baseObjectInputType<TShape>[k_1]; } : never>>(shape: TShape, fn: Task<z.infer<TSchema>>): BrandedTask<z.infer<TSchema>>;
+};

package/dist/tasks/task.js

@@ -0,0 +1,39 @@
+import { red } from "colorette";
+import { z } from "zod";
+import { fromZodError } from "zod-validation-error";
+const zodMessageBuilder = (issues) => issues
+    .map((issue) => {
+    const propertyName = issue.path[0];
+    if (issue.code === "unrecognized_keys") {
+        const keyList = issue.keys.map((key) => `--${key}`).join(", ");
+        return `${red("Unrecognized options")}: ${keyList}`;
+    }
+    if (!propertyName) {
+        return issue.message;
+    }
+    const optionText = propertyName === "_" ? "Positionals" : `--{propertyName}`;
+    // we currently assume there is only ever one path segment
+    return `${red(optionText)}: ${issue.message}`;
+})
+    .join("\n");
+export const task = (fn) => {
+    fn.kind = "task";
+    return fn;
+};
+task.strict = (shape, fn) => {
+    const schema = z.strictObject(shape);
+    const taskFunction = (options, utilities) => {
+        const { data, success, error } = schema.safeParse(options);
+        if (!success) {
+            throw new Error(fromZodError(error, { messageBuilder: zodMessageBuilder }).message, {
+                cause: error
+            });
+        }
+        return fn(data, utilities);
+    };
+    taskFunction.kind = "strictTask";
+    taskFunction.schema = schema;
+    taskFunction.inputSchema = shape;
+    return taskFunction;
+};
+//# sourceMappingURL=task.js.map

package/dist/tasks/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/tasks/task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAUpD,MAAM,iBAAiB,GAAmB,CAAC,MAAM,EAAE,EAAE,CACpD,MAAM;KACJ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;IACd,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,OAAO,GAAG,GAAG,CAAC,sBAAsB,CAAC,KAAK,OAAO,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GACf,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAE3D,0DAA0D;IAC1D,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;AAC/C,CAAC,CAAC;KACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAEd,MAAM,CAAC,MAAM,IAAI,GAAG,CAAoB,EAAW,EAAkB,EAAE;IACrE,EAAqB,CAAC,IAAI,GAAG,MAAM,CAAC;IACrC,OAAO,EAAoB,CAAC;AAC7B,CAAC,CAAC;AAEF,IAAI,CAAC,MAAM,GAAG,CAIb,KAAa,EACb,EAA0B,EACM,EAAE;IAClC,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAErC,MAAM,YAAY,GAAwC,CACzD,OAAO,EACP,SAAS,EACR,EAAE;QACH,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAE3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACd,YAAY,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAClE;gBACC,KAAK,EAAE,KAAK;aACZ,CACD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC,IAAwB,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC,CAAC;IAEF,YAAY,CAAC,IAAI,GAAG,YAAY,CAAC;IACjC,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,CAAC,WAAW,GAAG,KAAK,CAAC;IAEjC,OAAO,YAAY,CAAC;AACrB,CAAC,CAAC"}

package/dist/tasks/task.test.d.ts

@@ -0,0 +1 @@
+export {};