@clemrig/factory 0.0.0-stage → 0.2.0

package/dist/cli/args.js

@@ -0,0 +1,45 @@
+import { OPTION_NAME } from "../app/options.js";
+/** `--name value`, or `--name` alone for true; --json and --help never take a value. */
+export function parseArgs(argv) {
+    const positional = [];
+    const options = {};
+    let json = false;
+    let help = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i] ?? "";
+        if (!arg.startsWith("--")) {
+            positional.push(arg);
+            continue;
+        }
+        const name = arg.slice(2);
+        if (name === "json")
+            json = true;
+        else if (name === "help")
+            help = true;
+        else {
+            if (!OPTION_NAME.test(name))
+                throw new Error(`Invalid option ${arg}`);
+            if (Object.hasOwn(options, name))
+                throw new Error(`Duplicate option ${arg}`);
+            const value = argv[i + 1];
+            options[name] =
+                value === undefined || value.startsWith("--") ? true : value;
+            if (options[name] !== true)
+                i++;
+        }
+    }
+    return {
+        command: positional.shift() ?? "help",
+        positional,
+        options,
+        json,
+        help,
+    };
+}
+/** Commands other than `run` take no option of their own. */
+export function noOptions(args) {
+    const [name] = Object.keys(args.options);
+    if (name)
+        throw new Error(`Unknown option --${name} for ${args.command}`);
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWhD,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAyB,EAAE,CAAC;IACzC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,MAAM;YAAE,IAAI,GAAG,IAAI,CAAC;aAC5B,IAAI,IAAI,KAAK,MAAM;YAAE,IAAI,GAAG,IAAI,CAAC;aACjC,CAAC;YACJ,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAC;YACtE,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI;gBAAE,CAAC,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,MAAM;QACrC,UAAU;QACV,OAAO;QACP,IAAI;QACJ,IAAI;KACL,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,IAAe;IACvC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cli/doctor.d.ts

@@ -0,0 +1,5 @@
+import type { Workflow } from "@clemrig/flow";
+/** `factory run <name>` followed by the workflow's input options. */
+export declare function usage(workflow: Workflow): string;
+/** Node, the factory and its workflows' prompts, then each runtime in use; no provider request. */
+export declare function doctor(factoryDir: string, json: boolean): Promise<number>;

package/dist/cli/doctor.js

@@ -0,0 +1,33 @@
+import { diagnose } from "../app/doctor.js";
+import { isFlag } from "../app/options.js";
+/** `factory run <name>` followed by the workflow's input options. */
+export function usage(workflow) {
+    const options = Object.entries(workflow.input?.shape ?? {}).map(([name, schema]) => {
+        const option = isFlag(schema) ? `--${name}` : `--${name} <value>`;
+        return schema.safeParse(undefined).success ? `[${option}]` : option;
+    });
+    return ["factory run", workflow.name, ...options].join(" ");
+}
+/** Node, the factory and its workflows' prompts, then each runtime in use; no provider request. */
+export async function doctor(factoryDir, json) {
+    const { ok, node, factory, runtimes, problems, ...found } = await diagnose(factoryDir);
+    const workflows = {};
+    for (const { workflow, error } of found.workflows)
+        workflows[workflow.name] =
+            error === undefined
+                ? { ok: true, detail: `Workflow ${workflow.name}: ${usage(workflow)}` }
+                : { ok: false, detail: `Workflow ${workflow.name}: ${error}` };
+    if (json) {
+        process.stdout.write(`${JSON.stringify({ ok, node, factory, workflows, runtimes, problems })}\n`);
+        return ok ? 0 : 1;
+    }
+    const line = (check, text = check.detail) => `${check.ok ? "✓" : "✗"} ${text}`;
+    const lines = [
+        ...[node, factory, ...Object.values(workflows)].map((check) => line(check)),
+        ...Object.values(runtimes).map((check) => line(check)),
+        ...problems.map(({ stage, runtime, reason }) => `✗ ${stage} (${runtime}): ${reason}`),
+    ];
+    process.stdout.write(`${lines.join("\n")}\n`);
+    return ok ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/help.d.ts

@@ -0,0 +1 @@
+export declare const help = "factory \u2014 workflows written in this repository's .factory/\n\n  factory init                             create .factory/ here and install it\n  factory doctor [--json]                  check Node, workflows, prompts and runtimes\n  factory run WORKFLOW [--INPUT VALUE\u2026] [--max-cost-usd USD] [--json]\n  factory status [RUN_ID] [--json]         list this repository's runs, or show one\n  factory ui [--port N]                    serve a live read-only dashboard on 127.0.0.1\n\nCommands other than init and help use the nearest .factory/ in the current directory\nor a parent, with the factory version installed there. factory doctor lists each\nworkflow's input options. .factory/.env is loaded; shell variables take precedence.\n--max-cost-usd fails the run once its agents' announced cost exceeds it, instead\nof the workflow's maxCostUsd. --json writes events, then the result, as JSON lines.\nCtrl-C stops a run, which ends failed; press it again to quit at once.\nExit codes: 0 completed, 1 error or failed run, 130 second Ctrl-C.\n";

package/dist/cli/help.js

@@ -0,0 +1,17 @@
+export const help = `factory — workflows written in this repository's .factory/
+
+  factory init                             create .factory/ here and install it
+  factory doctor [--json]                  check Node, workflows, prompts and runtimes
+  factory run WORKFLOW [--INPUT VALUE…] [--max-cost-usd USD] [--json]
+  factory status [RUN_ID] [--json]         list this repository's runs, or show one
+  factory ui [--port N]                    serve a live read-only dashboard on 127.0.0.1
+
+Commands other than init and help use the nearest .factory/ in the current directory
+or a parent, with the factory version installed there. factory doctor lists each
+workflow's input options. .factory/.env is loaded; shell variables take precedence.
+--max-cost-usd fails the run once its agents' announced cost exceeds it, instead
+of the workflow's maxCostUsd. --json writes events, then the result, as JSON lines.
+Ctrl-C stops a run, which ends failed; press it again to quit at once.
+Exit codes: 0 completed, 1 error or failed run, 130 second Ctrl-C.
+`;
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;CAenB,CAAC"}

package/dist/cli/init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `factory init`: creates `.factory/` in `cwd` from the templates, pinned to this
+ * factory version, then installs it. An existing `.factory/` is refused untouched;
+ * a failed installation keeps the files.
+ */
+export declare function init(cwd: string): Promise<number>;

package/dist/cli/init.js

@@ -0,0 +1,18 @@
+import { createFactory, installFactory } from "../app/init.js";
+/**
+ * `factory init`: creates `.factory/` in `cwd` from the templates, pinned to this
+ * factory version, then installs it. An existing `.factory/` is refused untouched;
+ * a failed installation keeps the files.
+ */
+export async function init(cwd) {
+    const { factoryDir, version } = await createFactory(cwd);
+    process.stdout.write(`Created ${factoryDir}; installing @clemrig/factory ${version}…\n`);
+    const install = await installFactory(factoryDir);
+    if (!install.ok) {
+        process.stderr.write(`${install.output}\n`);
+        throw new Error("Installation failed; .factory/ is kept: run npm install --prefix .factory");
+    }
+    process.stdout.write('Next: commit .factory/, run factory doctor, then factory run ask --question "What changed recently?"\n');
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAW;IACpC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,WAAW,UAAU,iCAAiC,OAAO,KAAK,CACnE,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wGAAwG,CACzG,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/launcher.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The global `factory`: help and init run here; any other command runs with the
+ * factory version installed in the repository's `.factory/`.
+ */
+export declare function launch(argv: string[], cwd: string): Promise<number>;

package/dist/cli/launcher.js

@@ -0,0 +1,55 @@
+import { existsSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, relative } from "node:path";
+import { pathToFileURL } from "node:url";
+import { help } from "./help.js";
+import { init } from "./init.js";
+/** The nearest `.factory/` holding a package.json, in `cwd` or a parent. */
+function findFactory(cwd) {
+    for (let dir = cwd;; dir = dirname(dir)) {
+        const factoryDir = join(dir, ".factory");
+        if (existsSync(join(factoryDir, "package.json")))
+            return factoryDir;
+        if (dirname(dir) === dir)
+            return undefined;
+    }
+}
+/**
+ * The `main` entry of the factory installed in `.factory/`. Node's resolution also
+ * searches parent `node_modules`: a factory found there is never used.
+ */
+function installedCore(factoryDir, cwd) {
+    if (!existsSync(join(factoryDir, "node_modules", "@clemrig", "factory", "package.json"))) {
+        const lock = existsSync(join(factoryDir, "package-lock.json"));
+        throw new Error(`The factory is not installed in ${factoryDir}; run npm ${lock ? "ci" : "install"} --prefix ${relative(cwd, factoryDir)}`);
+    }
+    return createRequire(join(factoryDir, "package.json")).resolve("@clemrig/factory/cli");
+}
+/**
+ * The global `factory`: help and init run here; any other command runs with the
+ * factory version installed in the repository's `.factory/`.
+ */
+export async function launch(argv, cwd) {
+    try {
+        const [command] = argv;
+        if (command === undefined || command === "help" || command === "--help") {
+            process.stdout.write(help);
+            return 0;
+        }
+        if (command === "init") {
+            if (argv.length > 1)
+                throw new Error("factory init takes no argument");
+            return await init(cwd);
+        }
+        const factoryDir = findFactory(cwd);
+        if (!factoryDir || !statSync(factoryDir).isDirectory())
+            throw new Error(`No .factory/ found in ${cwd} or its parents; run factory init at the root of your repository`);
+        const { main } = (await import(pathToFileURL(installedCore(factoryDir, cwd)).href));
+        return await main(argv, factoryDir);
+    }
+    catch (error) {
+        process.stderr.write(`factory: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+//# sourceMappingURL=launcher.js.map

package/dist/cli/launcher.js.map

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

package/dist/cli/reporter.d.ts

@@ -0,0 +1,17 @@
+import { type RunEvent, type RunState } from "@clemrig/flow";
+/** The run's duration, then its agents' tokens and estimated cost. */
+export declare function metricsSummary(state: RunState, now?: number): string[];
+/** Stage events and journal on stderr; results on stdout; JSON lines on stdout with --json. */
+export declare class TerminalReporter {
+    #private;
+    constructor(
+    /** The result lines of a run's workflow. */
+    present: (state: Readonly<RunState>) => string[], json?: boolean);
+    event: (event: RunEvent) => void;
+    /** A runtime the run uses, with its version and connection; --json output stays events only. */
+    runtime: (detail: string) => void;
+    /** A line under the current stage: journal messages, agent activity and runtimes. */
+    detail: (message: string) => void;
+    unreadable(runId: string, message: string): void;
+    result(state: RunState): void;
+}

package/dist/cli/reporter.js

@@ -0,0 +1,122 @@
+import { elapsedMs, runtimeLabels, } from "@clemrig/flow";
+function duration(ms) {
+    const seconds = Math.max(0, Math.floor(ms / 1000));
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    return `${hours ? `${hours} h ` : ""}${minutes} min ${seconds % 60} s`;
+}
+/** The run's duration, then its agents' tokens and estimated cost. */
+export function metricsSummary(state, now = Date.now()) {
+    const elapsed = elapsedMs(state, now);
+    const usage = state.metrics?.usage;
+    const count = (n) => n.toLocaleString("en-US");
+    return [
+        `Duration: ${elapsed === null ? "unavailable" : duration(elapsed)}`,
+        !usage
+            ? "Agents: unavailable"
+            : usage.responses
+                ? `Agents: ${count(usage.input)} input · ${count(usage.output)} output · ${count(usage.cacheRead)} cache read · ${count(usage.cacheWrite)} cache write tokens · estimated cost ${usage.costUsd.toFixed(6)} USD${usage.missing ? " (partial)" : ""}`
+                : `Agents: ${usage.missing ? "unavailable (partial)" : "no measured call"}`,
+    ];
+}
+const icons = { started: "→", passed: "✓", failed: "✗", completed: "✓" };
+const inSeconds = (ms) => `${(ms / 1000).toFixed(1)} s`;
+/** An agent call's start and end, its finished tools and its warnings; not each response. */
+function activityLine(activity) {
+    switch (activity.kind) {
+        case "call":
+            return activity.status === "started"
+                ? `${runtimeLabels[activity.runtime]} started with ${activity.model}`
+                : `${runtimeLabels[activity.runtime]} ${activity.status}`;
+        case "tool":
+            return activity.status === "started"
+                ? undefined
+                : activity.status === "failed"
+                    ? `${activity.name} failed after ${inSeconds(activity.durationMs)}`
+                    : `${activity.name} ${inSeconds(activity.durationMs)}`;
+        case "warning":
+            return activity.message;
+        default:
+            return undefined;
+    }
+}
+/** Stage events and journal on stderr; results on stdout; JSON lines on stdout with --json. */
+export class TerminalReporter {
+    #present;
+    #json;
+    constructor(
+    /** The result lines of a run's workflow. */
+    present, json = false) {
+        this.#present = present;
+        this.#json = json;
+    }
+    event = (event) => {
+        if (this.#json) {
+            process.stdout.write(`${JSON.stringify(event)}\n`);
+            return;
+        }
+        if (event.type === "log") {
+            this.detail(event.message);
+            return;
+        }
+        if (event.type === "agent") {
+            const line = activityLine(event.activity);
+            if (line)
+                this.detail(line);
+            return;
+        }
+        const correction = event.decision?.verdict === "correction";
+        const icon = correction && event.status !== "failed" ? "↻" : icons[event.status];
+        const color = process.stderr.isTTY && !process.env.NO_COLOR
+            ? event.status === "failed"
+                ? "\x1b[31m"
+                : correction
+                    ? "\x1b[33m"
+                    : event.status === "started"
+                        ? "\x1b[36m"
+                        : "\x1b[32m"
+            : "";
+        const label = event.decision
+            ? `${event.decision.verdict}${event.status === "failed" ? " · failed" : ""}`
+            : event.status;
+        const reasonInDetail = event.decision && event.detail?.includes(event.decision.reason);
+        const decision = event.decision
+            ? `${reasonInDetail ? "" : ` — ${event.decision.reason}`} → ${event.decision.destination ?? "end"}`
+            : "";
+        const retry = event.retry
+            ? ` [${event.retry.key} ${event.retry.count}/${event.retry.max}]`
+            : "";
+        process.stderr.write(`${color}${icon} ${event.kind.padEnd(6)} ${event.stage.padEnd(24)} ${label}${color ? "\x1b[0m" : ""}${decision}${retry}${event.detail ? ` — ${event.detail}` : ""}\n`);
+    };
+    /** A runtime the run uses, with its version and connection; --json output stays events only. */
+    runtime = (detail) => {
+        if (!this.#json)
+            this.detail(detail);
+    };
+    /** A line under the current stage: journal messages, agent activity and runtimes. */
+    detail = (message) => {
+        process.stderr.write(`  · ${message}\n`);
+    };
+    unreadable(runId, message) {
+        if (this.#json)
+            process.stdout.write(`${JSON.stringify({ type: "unreadable", runId, error: message })}\n`);
+        else
+            process.stdout.write(`\n${runId} · unreadable\n${message}\n`);
+    }
+    result(state) {
+        if (this.#json) {
+            process.stdout.write(`${JSON.stringify({ type: "result", state, elapsedMs: elapsedMs(state) })}\n`);
+            return;
+        }
+        const lines = [
+            "",
+            `${state.workflow} · ${state.id} · ${state.status}`,
+            ...(state.error ? [state.error] : []),
+            ...metricsSummary(state),
+            ...Object.values(state.runtimes ?? {}).map((runtime) => `Runtime: ${runtime}`),
+            ...this.#present(state),
+        ];
+        process.stdout.write(`${lines.join("\n")}\n`);
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/cli/reporter.js.map

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

package/dist/cli/run.d.ts

@@ -0,0 +1,5 @@
+import type { Factory } from "../app/factory.js";
+import type { Arguments } from "./args.js";
+import type { TerminalReporter } from "./reporter.js";
+/** `factory run`: the run executes in the foreground, with the repository as the current directory. */
+export declare function run(factory: Factory, args: Arguments, reporter: TerminalReporter): Promise<number>;

package/dist/cli/run.js

@@ -0,0 +1,52 @@
+import { killChildProcesses } from "@clemrig/flow";
+import { startRun } from "../app/run.js";
+/**
+ * Starts the run and waits for its end. The first SIGINT or SIGTERM stops it
+ * before its next stage (child processes are stopped at once); a second one
+ * kills the child process groups and exits with 130.
+ */
+async function execute(factory, name, options, reporter) {
+    const started = await startRun(factory, name, options, {
+        onEvent: reporter.event,
+    });
+    for (const runtime of started.runtimes)
+        reporter.runtime(runtime.detail);
+    let interrupted = false;
+    const interrupt = (signal) => {
+        if (interrupted) {
+            killChildProcesses();
+            process.exit(130);
+        }
+        interrupted = true;
+        reporter.detail(`${signal} received: stopping the run; press Ctrl-C again to quit at once`);
+        started.stop(new Error(`Run interrupted by ${signal}`));
+    };
+    process.on("SIGINT", interrupt);
+    process.on("SIGTERM", interrupt);
+    try {
+        return await started.done;
+    }
+    finally {
+        process.off("SIGINT", interrupt);
+        process.off("SIGTERM", interrupt);
+    }
+}
+/** `factory run`: the run executes in the foreground, with the repository as the current directory. */
+export async function run(factory, args, reporter) {
+    const name = args.positional[0];
+    if (!name)
+        throw new Error(`Usage: factory run WORKFLOW [--INPUT VALUE…]; workflows: ${[...factory.workflows.keys()].join(", ") || "none"}`);
+    // Relative paths in workflow code resolve in the repository, wherever the command was started.
+    const previous = process.cwd();
+    process.chdir(factory.dir);
+    let state;
+    try {
+        state = await execute(factory, name, args.options, reporter);
+    }
+    finally {
+        process.chdir(previous);
+    }
+    reporter.result(state);
+    return state.status === "completed" ? 0 : 1;
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiB,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC;;;;GAIG;AACH,KAAK,UAAU,OAAO,CACpB,OAAgB,EAChB,IAAY,EACZ,OAA6B,EAC7B,QAA0B;IAE1B,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;QACrD,OAAO,EAAE,QAAQ,CAAC,KAAK;KACxB,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ;QAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,MAAM,SAAS,GAAG,CAAC,MAAsB,EAAE,EAAE;QAC3C,IAAI,WAAW,EAAE,CAAC;YAChB,kBAAkB,EAAE,CAAC;YACrB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,WAAW,GAAG,IAAI,CAAC;QACnB,QAAQ,CAAC,MAAM,CACb,GAAG,MAAM,iEAAiE,CAC3E,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,OAAgB,EAChB,IAAe,EACf,QAA0B;IAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QACP,MAAM,IAAI,KAAK,CACb,4DAA4D,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CACjH,CAAC;IACJ,+FAA+F;IAC/F,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IACD,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/cli/status.d.ts

@@ -0,0 +1,4 @@
+import type { Factory } from "../app/factory.js";
+import type { TerminalReporter } from "./reporter.js";
+/** Every run of the repository, or one run. */
+export declare function status(factory: Factory, reporter: TerminalReporter, runId: string | undefined): Promise<number>;

package/dist/cli/status.js

@@ -0,0 +1,15 @@
+import { listRuns, loadRun } from "@clemrig/flow";
+/** Every run of the repository, or one run. */
+export async function status(factory, reporter, runId) {
+    if (runId) {
+        reporter.result(await loadRun(factory.runsDir, runId));
+        return 0;
+    }
+    for (const entry of await listRuns(factory.runsDir))
+        if ("state" in entry)
+            reporter.result(entry.state);
+        else
+            reporter.unreadable(entry.id, entry.error);
+    return 0;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAIlD,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,OAAgB,EAChB,QAA0B,EAC1B,KAAyB;IAEzB,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;QACjD,IAAI,OAAO,IAAI,KAAK;YAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;;YAC9C,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/cli/ui.d.ts

@@ -0,0 +1,3 @@
+import type { Factory } from "../app/factory.js";
+/** `factory ui`: serves the dashboard of the repository's runs until Ctrl-C, on `port` or one the system chooses. */
+export declare function ui(factory: Factory, port?: number): Promise<number>;

package/dist/cli/ui.js

@@ -0,0 +1,25 @@
+import { basename } from "node:path";
+import { startDashboard } from "@clemrig/flow-ui";
+import { presentResult } from "../app/runs.js";
+/** `factory ui`: serves the dashboard of the repository's runs until Ctrl-C, on `port` or one the system chooses. */
+export async function ui(factory, port) {
+    const dashboard = await startDashboard({
+        runsDir: factory.runsDir,
+        title: "factory",
+        label: basename(factory.dir),
+        presentResult: (state) => presentResult(factory, state),
+    }, port);
+    process.stdout.write(`factory ui: ${dashboard.url} (read-only; Ctrl-C to stop)\n`);
+    await new Promise((resolve) => {
+        const stop = () => {
+            process.off("SIGINT", stop);
+            process.off("SIGTERM", stop);
+            resolve();
+        };
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+    });
+    await dashboard.close();
+    return 0;
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qHAAqH;AACrH,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,OAAgB,EAAE,IAAa;IACtD,MAAM,SAAS,GAAG,MAAM,cAAc,CACpC;QACE,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;QAC5B,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC;KACxD,EACD,IAAI,CACL,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,SAAS,CAAC,GAAG,gCAAgC,CAC7D,CAAC;IACF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;IACxB,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Public API for writing workflows. A repository's `.factory/` imports only this
+ * module; it re-exports the engine's, `z` included, so that workflows, the
+ * factory and the engine share one Zod instance.
+ */
+export { type AgentProfile, agent, type Check, code, defineWorkflow, END, gate, type Log, node, ProcessInterruptedError, pick, type RunState, retry, runProcess, type Stage, type StageContext, type StageResult, schemaGate, step, type WorkflowDefinition, z, } from "@clemrig/flow";

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * Public API for writing workflows. A repository's `.factory/` imports only this
+ * module; it re-exports the engine's, `z` included, so that workflows, the
+ * factory and the engine share one Zod instance.
+ */
+export { agent, code, defineWorkflow, END, gate, node, ProcessInterruptedError, pick, retry, runProcess, schemaGate, step, z, } from "@clemrig/flow";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,EAEL,IAAI,EACJ,cAAc,EACd,GAAG,EACH,IAAI,EAEJ,IAAI,EACJ,uBAAuB,EACvB,IAAI,EAEJ,KAAK,EACL,UAAU,EAIV,UAAU,EACV,IAAI,EAEJ,CAAC,GACF,MAAM,eAAe,CAAC"}

package/dist/main.d.ts

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

package/dist/main.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { launch } from "./cli/launcher.js";
+process.exitCode = await launch(process.argv.slice(2), process.cwd());
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC"}

package/dist/system/environment.d.ts

@@ -0,0 +1,2 @@
+/** Optional `.factory/.env` secrets; existing shell variables retain precedence. */
+export declare function loadLocalEnvironment(factoryDir: string): void;

package/dist/system/environment.js

@@ -0,0 +1,13 @@
+import { join } from "node:path";
+import { loadEnvFile } from "node:process";
+/** Optional `.factory/.env` secrets; existing shell variables retain precedence. */
+export function loadLocalEnvironment(factoryDir) {
+    try {
+        loadEnvFile(join(factoryDir, ".env"));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw new Error(`Cannot load .env from ${factoryDir}`);
+    }
+}
+//# sourceMappingURL=environment.js.map

package/dist/system/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/system/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/system/factory.d.ts

@@ -0,0 +1,16 @@
+import { type Workflow } from "@clemrig/flow";
+/** A repository's `.factory/`: its workflows, where they work and where runs are kept. */
+export interface Factory {
+    /** The repository: the directory that contains `.factory/`. */
+    dir: string;
+    factoryDir: string;
+    runsDir: string;
+    workflows: Map<string, Workflow>;
+}
+/** A factory without workflows, to read runs when `factory.ts` cannot load. */
+export declare function emptyFactory(factoryDir: string): Factory;
+/** Imports `.factory/factory.ts`, whose default export lists the repository's workflows. */
+export declare function loadFactory(factoryDir: string): Promise<Factory>;
+export declare function workflowOf(factory: Factory, name: string): Workflow;
+/** Reads `workflows/<workflow>/prompts/<name>.md` for each agent stage of the workflow, at every run. */
+export declare function loadPrompts(factoryDir: string, workflow: Workflow): Promise<Record<string, string>>;