@clemrig/factory 0.1.0 → 0.2.1

package/README.md

@@ -26,7 +26,7 @@ factory run ask --question "What changed recently?"
 
 ```
 .factory/
-  package.json             pins the exact core version
+  package.json             pins the exact factory version
   factory.ts               the repository's workflows
   workflows/ask/
     index.ts               the example workflow
@@ -37,7 +37,7 @@ factory run ask --question "What changed recently?"
   .env                     optional secrets (ignored)
 ```
 
-The global `factory` command uses the nearest `.factory/` holding a `package.json`, in the current directory or a parent, and runs the core version installed there: every machine runs the version pinned in the repository. Only `factory init` and `factory help` run with the global version. Without `.factory/` the command asks for `factory init`; without installed dependencies it gives the `npm ci --prefix .factory` command to run.
+The global `factory` command uses the nearest `.factory/` holding a `package.json`, in the current directory or a parent, and runs the factory version installed there: every machine runs the version pinned in the repository. Only `factory init` and `factory help` run with the global version. Without `.factory/` the command asks for `factory init`; without installed dependencies it gives the `npm ci --prefix .factory` command to run.
 
 The example workflow `ask` reads the last 10 commits with `git log` (a CODE stage), asks a read-only Claude Code agent (`claude-sonnet-5-5`, effort `low`, tools `Read`, `Grep`, `Glob`) to answer the question, and checks the answer with a gate that sends it back at most 3 times. Copy its folder to start a new workflow.
 
@@ -119,7 +119,7 @@ import changelog from "./workflows/changelog/index.ts";
 export default [ask, changelog];
 ```
 
-Workflows are TypeScript run directly by Node: use erasable syntax only (no `enum`, no parameter properties) and relative imports with their `.ts` extension. Import the core only from `@clemrig/factory`, which also exports `z` (Zod), so that workflows and the core share one Zod instance.
+Workflows are TypeScript run directly by Node: use erasable syntax only (no `enum`, no parameter properties) and relative imports with their `.ts` extension. Import only from `@clemrig/factory`, which also exports `z` (Zod), so that workflows, the factory and its engine share one Zod instance.
 
 **Graph.** Each stage declares its outcomes and the node routes every outcome to a stage, to `END` or to `retry(stage, max)`. A stage receives `{ state, agent, log, dir }`: the run (read-only), the agent runtime, the run journal and the repository directory. Stages and agents work in the repository (the folder that contains `.factory/`), which is also the process's working directory during a run, wherever the command was started.
 
@@ -132,7 +132,7 @@ Workflows are TypeScript run directly by Node: use erasable syntax only (no `enu
 | `pick(...keys)` | agent context from `input` and data keys |
 | `runProcess(argv, cwd, timeoutMs)` | runs a command without a shell; Ctrl-C stops it |
 
-`defineWorkflow` refuses, when the workflow is loaded: a `.` in a stage or outcome name (a correction counter is named `<stage>.<outcome>`), an unrouted outcome, an unknown target, a retry maximum outside 1–100, a loop whose edges include no `retry` (with the loop's path), an invalid profile, a write tool in a read-only profile, a prompt or session name that cannot name a file, a `maxCostUsd` that is not a positive number, and an input that is not a `z.object` or uses the names `json`, `help` or `max-cost-usd`. Every run is therefore bounded.
+`defineWorkflow` refuses, when the workflow is loaded: a `.` in a stage or outcome name (a correction counter is named `<stage>.<outcome>`), an unrouted outcome, an unknown target, a retry maximum outside 1–100, a loop whose edges include no `retry` (with the loop's path), an invalid profile, a write tool in a read-only profile, a prompt or session name that cannot name a file, a `maxCostUsd` that is not a positive number, and an input that is not a `z.object`. Loading `factory.ts` also refuses an input whose name cannot be an option (`json`, `help`, `max-cost-usd`, or other than letters, digits, `-` and `_` after a letter). Every run is therefore bounded.
 
 **Inputs.** Each field of `input` becomes a `--<name>` option of `factory run`; an option given without a value is `true` and only a boolean field accepts it: `z.boolean()`, possibly with `.optional()`, `.nullable()` or `.default(…)` (a transformed boolean or one with `.catch` takes no option alone). A missing, invalid or unknown option is refused with the list of problems, before any run is created. A workflow without `input` accepts no input option.
 
@@ -165,7 +165,7 @@ factory ui [--port 4321]
 factory doctor [--json]
 ```
 
-Before creating a run, `factory run` validates the input, reads the prompts and checks, for each runtime the workflow uses, that its executable is in the `PATH`, at least the supported version, and connected; a missing piece fails the command with the stage, runtime and reason. The terminal then shows each runtime's version and connection. A model the account cannot use fails the run at its first call, with the runtime's message.
+Before creating a run, `factory run` validates the input, reads the prompts and checks from the repository, where the agents will work, for each runtime the workflow uses, that its executable is in the `PATH`, at least the supported version, and connected; a missing piece fails the command with the stage, runtime and reason. The terminal then shows each runtime's version and connection. A model the account cannot use fails the run at its first call, with the runtime's message.
 
 The run executes in the foreground. The terminal shows each stage's start and end, decisions and corrections with their counter (`[check.invalid 1/3]`), journal messages and, for an agent, the start and end of its call, each finished tool with its duration and isolation warnings; then the result, the duration, the agents' tokens and estimated cost, and the runtimes used. `--json` writes every event, then the result, as JSON lines on standard output. Exit codes: 0 completed, 1 error or failed run.
 
@@ -183,17 +183,6 @@ Tokens and costs are the figures each runtime announces, never recomputed: Claud
 
 Not in this version: resuming a run, detached runs, logs `--follow` and stop, local settings or profile overrides, actions or graph drawing in the dashboard, runs of several repositories, `factory new`, a shared stage library, a test harness for workflows, CI, cron or Git hook triggers, notifications, Windows.
 
-## Develop the core
-
-```sh
-npm ci
-npm run check        # lint, format, typecheck, tests with coverage, build
-npm run build
-npm pack             # then, in a test repository: npm install --no-save --prefix .factory /path/to/clemrig-factory-0.1.0.tgz
-```
-
-`npm link` in this repository provides a global `factory` built from it; a test repository still runs the core installed in its `.factory/`. See [AGENTS.md](AGENTS.md), [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) and the [decisions](docs/decisions/README.md) (in French).
-
 ## License
 
-[MIT](LICENSE)
+MIT

package/dist/app/doctor.d.ts

@@ -1,7 +1,5 @@
-import type { Runtime } from "../engine/profiles.js";
-import type { Workflow } from "../engine/types.js";
-import { type AgentProblem, type RuntimeStatus } from "../system/runtimes/inspect.js";
-export type { AgentProblem, RuntimeStatus, } from "../system/runtimes/inspect.js";
+import { type AgentProblem, type Runtime, type RuntimeStatus, type Workflow } from "@clemrig/flow";
+export type { RuntimeStatus } from "@clemrig/flow";
 /** What `factory doctor` found, without any provider request. */
 export interface Diagnosis {
     ok: boolean;

package/dist/app/doctor.js

@@ -1,6 +1,7 @@
+import { inspectNode, inspectRuntimes, } from "@clemrig/flow";
 import { loadLocalEnvironment } from "../system/environment.js";
-import { loadFactory, loadPrompts } from "../system/factory.js";
-import { inspectNode, inspectRuntimes, } from "../system/runtimes/inspect.js";
+import { emptyFactory, loadPrompts } from "../system/factory.js";
+import { loadWorkflows } from "./factory.js";
 const message = (error) => error instanceof Error ? error.message : String(error);
 /** Node, the factory and its workflows' prompts, then each runtime in use. */
 export async function diagnose(factoryDir) {
@@ -9,7 +10,7 @@ export async function diagnose(factoryDir) {
     let factory;
     let loaded;
     try {
-        factory = await loadFactory(factoryDir);
+        factory = await loadWorkflows(factoryDir);
         loaded = { ok: true, detail: `Factory ${factoryDir}` };
     }
     catch (error) {
@@ -28,7 +29,8 @@ export async function diagnose(factoryDir) {
         for (const [stage, declared] of Object.entries(workflow.agents))
             agents[`${workflow.name}.${stage}`] = declared;
     }
-    const { runtimes, problems } = await inspectRuntimes(agents);
+    // Where the agents will work: the repository.
+    const { runtimes, problems } = await inspectRuntimes(agents, factory?.dir ?? emptyFactory(factoryDir).dir);
     const ok = node.ok &&
         loaded.ok &&
         workflows.every(({ error }) => error === undefined) &&

package/dist/app/doctor.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/app/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAgB,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAEL,WAAW,EACX,eAAe,GAEhB,MAAM,+BAA+B,CAAC;AAmBvC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,OAA4B,CAAC;IACjC,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,UAAU,EAAE,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7D,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC;IACnD,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,EAAE,GACN,IAAI,CAAC,EAAE;QACP,MAAM,CAAC,EAAE;QACT,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;QACnD,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;IACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/app/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,WAAW,EACX,eAAe,GAIhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAgB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgB7C,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAkB;IAC/C,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,OAA4B,CAAC;IACjC,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,UAAU,EAAE,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,SAAS,GAA2B,EAAE,CAAC;IAC7C,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC7D,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC;IACnD,CAAC;IACD,8CAA8C;IAC9C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CAClD,MAAM,EACN,OAAO,EAAE,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC,GAAG,CAC7C,CAAC;IACF,MAAM,EAAE,GACN,IAAI,CAAC,EAAE;QACP,MAAM,CAAC,EAAE;QACT,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;QACnD,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC;IACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACtE,CAAC"}

package/dist/app/factory.d.ts

@@ -1,5 +1,7 @@
 import { type Factory } from "../system/factory.js";
 export type { Factory } from "../system/factory.js";
+/** The repository's workflows, each of whose inputs can be given as options of `factory run`. */
+export declare function loadWorkflows(factoryDir: string): Promise<Factory>;
 /** Loads `.factory/.env` without overriding the shell, then the repository's workflows. */
 export declare function openFactory(factoryDir: string): Promise<Factory>;
 /**

package/dist/app/factory.js

@@ -1,10 +1,21 @@
 import { loadLocalEnvironment } from "../system/environment.js";
 import { emptyFactory, loadFactory } from "../system/factory.js";
+import { optionProblems } from "./options.js";
 const message = (error) => error instanceof Error ? error.message : String(error);
+/** The repository's workflows, each of whose inputs can be given as options of `factory run`. */
+export async function loadWorkflows(factoryDir) {
+    const factory = await loadFactory(factoryDir);
+    for (const workflow of factory.workflows.values()) {
+        const problems = optionProblems(workflow);
+        if (problems.length)
+            throw new Error(`Invalid workflow ${workflow.name}: ${problems.join("; ")}`);
+    }
+    return factory;
+}
 /** Loads `.factory/.env` without overriding the shell, then the repository's workflows. */
 export async function openFactory(factoryDir) {
     loadLocalEnvironment(factoryDir);
-    return loadFactory(factoryDir);
+    return loadWorkflows(factoryDir);
 }
 /**
  * The factory to read runs with: while `factory.ts` cannot load, its runs stay
@@ -13,7 +24,7 @@ export async function openFactory(factoryDir) {
 export async function openFactoryForReading(factoryDir) {
     loadLocalEnvironment(factoryDir);
     try {
-        return { factory: await loadFactory(factoryDir) };
+        return { factory: await loadWorkflows(factoryDir) };
     }
     catch (error) {
         return { factory: emptyFactory(factoryDir), error: message(error) };

package/dist/app/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/app/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAgB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAI/E,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,WAAW,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB;IAElB,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACtE,CAAC;AACH,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/app/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAgB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE,CACjC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzD,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;IAC9C,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,QAAQ,CAAC,MAAM;YACjB,MAAM,IAAI,KAAK,CACb,oBAAoB,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;IACN,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAkB;IAClD,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,UAAkB;IAElB,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACtE,CAAC;AACH,CAAC"}

package/dist/app/init.d.ts

@@ -1,6 +1,2 @@
+export { npmInstall as installFactory } from "../system/npm.js";
 export { createFromTemplates as createFactory } from "../system/templates.js";
-/** Installs `.factory/`'s dependencies; `output` explains a failure. */
-export declare function installFactory(factoryDir: string): Promise<{
-    ok: boolean;
-    output: string;
-}>;

package/dist/app/init.js

@@ -1,15 +1,3 @@
-import { runProcess } from "../system/process.js";
+export { npmInstall as installFactory } from "../system/npm.js";
 export { createFromTemplates as createFactory } from "../system/templates.js";
-/** Installs `.factory/`'s dependencies; `output` explains a failure. */
-export async function installFactory(factoryDir) {
-    const install = await runProcess(["npm", "install", "--no-audit", "--no-fund"], factoryDir, 600_000).catch((error) => ({
-        exitCode: 1,
-        stdout: "",
-        stderr: error instanceof Error ? error.message : String(error),
-    }));
-    return {
-        ok: install.exitCode === 0,
-        output: install.stderr || install.stdout,
-    };
-}
 //# sourceMappingURL=init.js.map

package/dist/app/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/app/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,mBAAmB,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE9E,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAkB;IAElB,MAAM,OAAO,GAAG,MAAM,UAAU,CAC9B,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,CAAC,EAC7C,UAAU,EACV,OAAO,CACR,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC;QAC3B,QAAQ,EAAE,CAAC;QACX,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KAC/D,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,QAAQ,KAAK,CAAC;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;KACzC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/app/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,mBAAmB,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/app/options.d.ts

@@ -0,0 +1,17 @@
+import { type Workflow, type z } from "@clemrig/flow";
+/** What an option may be called, after its `--`. */
+export declare const OPTION_NAME: RegExp;
+/** Why some inputs of the workflow cannot be given as `--<name>` options of `factory run`. */
+export declare function optionProblems(workflow: Pick<Workflow, "input">): string[];
+/** Whether a field takes an option given alone: a boolean, possibly optional or defaulted. */
+export declare function isFlag(schema: z.ZodType): boolean;
+/**
+ * The input that `factory run` options give the workflow. An option given
+ * without a value is `true`, accepted only by a boolean field: otherwise it is
+ * refused with every other problem, found by validating the input once.
+ */
+export declare function inputFromOptions(workflow: Pick<Workflow, "name" | "input">, options: Record<string, string | boolean>): Record<string, string | boolean>;
+/** A refused input of `factory run`, worded as options; any other error as it is. */
+export declare function asOptionsError(workflow: Pick<Workflow, "name">, options: Record<string, string | boolean>, error: unknown): unknown;
+/** `--max-cost-usd`: the run's budget instead of the workflow's. */
+export declare function parseBudget(value: string | boolean): number;

package/dist/app/options.js

@@ -0,0 +1,78 @@
+import { InvalidInputError, parseInput, } from "@clemrig/flow";
+/** Options of every `factory run`: no input may take their names. */
+const GLOBAL_OPTIONS = ["json", "help", "max-cost-usd"];
+/** What an option may be called, after its `--`. */
+export const OPTION_NAME = /^[a-zA-Z][a-zA-Z0-9_-]*$/;
+/** Why some inputs of the workflow cannot be given as `--<name>` options of `factory run`. */
+export function optionProblems(workflow) {
+    return Object.keys(workflow.input?.shape ?? {}).flatMap((name) => GLOBAL_OPTIONS.includes(name)
+        ? [`input ${name} conflicts with the global --${name} option`]
+        : OPTION_NAME.test(name)
+            ? []
+            : [`input ${name} is not a valid option name`]);
+}
+/** Whether a field takes an option given alone: a boolean, possibly optional or defaulted. */
+export function isFlag(schema) {
+    let def = schema.def;
+    while (def.innerType &&
+        ["optional", "nullable", "default"].includes(def.type))
+        def = def.innerType.def;
+    return def.type === "boolean";
+}
+/** Options given without a value to a field that is not a boolean: they have no value to give. */
+function valueless(workflow, options) {
+    const shape = workflow.input?.shape ?? {};
+    return Object.keys(options).filter((name) => {
+        const field = Object.hasOwn(shape, name) ? shape[name] : undefined;
+        return options[name] === true && field !== undefined && !isFlag(field);
+    });
+}
+/** Every problem of `factory run` options, worded as options. */
+function optionsError(workflow, options, missingValues, problems) {
+    const found = missingValues.map((name) => `--${name}: missing value`);
+    for (const { kind, field, message } of problems) {
+        const name = field.split(".")[0] ?? "";
+        if (kind === "unknown")
+            found.push(`unknown option --${field}`);
+        else if (!missingValues.includes(name))
+            found.push(Object.hasOwn(options, name)
+                ? `--${name}: ${message}`
+                : `missing option --${name}`);
+    }
+    return new Error(`Invalid input for ${workflow.name}: ${found.join("; ")}`);
+}
+/**
+ * The input that `factory run` options give the workflow. An option given
+ * without a value is `true`, accepted only by a boolean field: otherwise it is
+ * refused with every other problem, found by validating the input once.
+ */
+export function inputFromOptions(workflow, options) {
+    const missingValues = valueless(workflow, options);
+    const input = Object.fromEntries(Object.entries(options).filter(([name]) => !missingValues.includes(name)));
+    if (!missingValues.length)
+        return input;
+    let problems = [];
+    try {
+        parseInput(workflow, input);
+    }
+    catch (error) {
+        if (!(error instanceof InvalidInputError))
+            throw error;
+        problems = error.problems;
+    }
+    throw optionsError(workflow, options, missingValues, problems);
+}
+/** A refused input of `factory run`, worded as options; any other error as it is. */
+export function asOptionsError(workflow, options, error) {
+    return error instanceof InvalidInputError
+        ? optionsError(workflow, options, [], error.problems)
+        : error;
+}
+/** `--max-cost-usd`: the run's budget instead of the workflow's. */
+export function parseBudget(value) {
+    const budget = Number(value);
+    if (typeof value !== "string" || !Number.isFinite(budget) || budget <= 0)
+        throw new Error(`Invalid --max-cost-usd ${String(value)}: expected a positive number of USD`);
+    return budget;
+}
+//# sourceMappingURL=options.js.map

package/dist/app/options.js.map

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

package/dist/app/run.d.ts

@@ -1,24 +1,8 @@
-import type { RunEvent, RunState } from "../engine/types.js";
+import { type RunHooks, type StartedRun } from "@clemrig/flow";
 import { type Factory } from "../system/factory.js";
-import { type RuntimeStatus } from "../system/runtimes/inspect.js";
-export interface RunHooks {
-    /** Each stage, journal and agent event, once recorded. */
-    onEvent(event: RunEvent): void;
-}
-/** A created run, executing in the foreground. */
-export interface StartedRun {
-    state: Readonly<RunState>;
-    /** Each runtime the run uses: version, executable and connection. */
-    runtimes: RuntimeStatus[];
-    /** Settles with the run once it completed or failed. */
-    done: Promise<RunState>;
-    /** Fails the run with `reason` before its next stage. */
-    stop(reason: Error): void;
-    /** Kills the child process groups still running, before quitting at once. */
-    kill(): void;
-}
 /**
- * Checks input, budget, prompts and runtimes before creating the run, then runs
- * it in the repository that contains `.factory/`, whatever the working directory.
+ * Starts a workflow of the factory from `factory run` options, with its prompts
+ * from `.factory/`; the run works in the repository that contains `.factory/`
+ * and is kept in its `runs/`.
  */
 export declare function startRun(factory: Factory, name: string, options: Record<string, string | boolean>, hooks: RunHooks): Promise<StartedRun>;

package/dist/app/run.js

@@ -1,100 +1,29 @@
-import { budgetProblem, emptyMetrics, recordUsage } from "../engine/metrics.js";
-import { executeWorkflow } from "../engine/runner.js";
-import { parseInput } from "../engine/workflow.js";
+import { startRun as start, } from "@clemrig/flow";
 import { loadPrompts, workflowOf } from "../system/factory.js";
-import { inDirectory, killProcessGroups } from "../system/process.js";
-import { AgentRuntime } from "../system/runtimes/agent-runtime.js";
-import { inspectRuntimes, } from "../system/runtimes/inspect.js";
-import { FileRunStore, newRunId } from "../system/store.js";
-/** `--max-cost-usd`: the run's budget instead of the workflow's. */
-function parseBudget(value) {
-    const budget = Number(value);
-    if (typeof value !== "string" || !Number.isFinite(budget) || budget <= 0)
-        throw new Error(`Invalid --max-cost-usd ${String(value)}: expected a positive number of USD`);
-    return budget;
-}
+import { asOptionsError, inputFromOptions, parseBudget } from "./options.js";
 /**
- * Checks input, budget, prompts and runtimes before creating the run, then runs
- * it in the repository that contains `.factory/`, whatever the working directory.
+ * Starts a workflow of the factory from `factory run` options, with its prompts
+ * from `.factory/`; the run works in the repository that contains `.factory/`
+ * and is kept in its `runs/`.
  */
 export async function startRun(factory, name, options, hooks) {
     const workflow = workflowOf(factory, name);
-    const { "max-cost-usd": budget, ...inputOptions } = options;
-    const maxCostUsd = budget === undefined ? workflow.maxCostUsd : parseBudget(budget);
-    const input = parseInput(workflow, inputOptions);
-    const prompts = await loadPrompts(factory.factoryDir, workflow);
-    const { runtimes, problems, executables } = await inspectRuntimes(workflow.agents);
-    if (problems.length)
-        throw new Error(`Missing prerequisites: ${problems.map(({ stage, runtime, reason }) => `stage ${stage} (${runtime}): ${reason}`).join("; ")}`);
-    const now = new Date().toISOString();
-    const state = {
-        version: 4,
-        id: newRunId(),
-        workflow: name,
-        input,
-        stage: workflow.initial,
-        status: "running",
-        data: {},
-        createdAt: now,
-        updatedAt: now,
-        metrics: emptyMetrics(),
-        runtimes: Object.fromEntries(Object.entries(runtimes).map(([runtime, { detail }]) => [
-            runtime,
-            detail,
-        ])),
-    };
-    const store = new FileRunStore(factory.runsDir, state.id);
-    const agent = new AgentRuntime({
-        dir: factory.dir,
-        factoryDir: factory.factoryDir,
-        prompts,
-        onUsage: async (report) => {
-            if (state.metrics)
-                recordUsage(state.metrics, report);
-            await store.save(state);
-        },
-        run: { id: state.id, directory: store.directory },
-        executables,
-    });
-    await store.save(state);
-    const controller = new AbortController();
-    /**
-     * Past its budget, the run stops: the abort fails it at its next stage
-     * boundary even if workflow code catches the error, and no call starts.
-     */
-    const overBudget = () => {
-        const problem = maxCostUsd === undefined || !state.metrics
-            ? undefined
-            : budgetProblem(state.metrics, maxCostUsd);
-        if (problem)
-            controller.abort(new Error(problem));
-        return problem;
-    };
-    // Checked before each agent call and after it, failed or not, on the figures its runtime announced.
-    const budgeted = {
-        async execute(request, record) {
-            const refused = overBudget();
-            if (refused)
-                throw new Error(refused);
-            const value = await agent
-                .execute(request, record)
-                .finally(() => overBudget());
-            const exceeded = overBudget();
-            if (exceeded)
-                throw new Error(exceeded);
-            return value;
-        },
-    };
-    const done = inDirectory(factory.dir, () => executeWorkflow(workflow, state, { agent: budgeted, dir: factory.dir }, store, {
-        onEvent: hooks.onEvent,
-        signal: controller.signal,
-    }));
-    return {
-        state,
-        runtimes: Object.values(runtimes),
-        done,
-        stop: (reason) => controller.abort(reason),
-        kill: killProcessGroups,
-    };
+    const { "max-cost-usd": budget, ...given } = options;
+    const maxCostUsd = budget === undefined ? undefined : parseBudget(budget);
+    const input = inputFromOptions(workflow, given);
+    try {
+        return await start({
+            workflow,
+            input,
+            maxCostUsd,
+            prompts: () => loadPrompts(factory.factoryDir, workflow),
+            dir: factory.dir,
+            configDir: factory.factoryDir,
+            runsDir: factory.runsDir,
+        }, hooks);
+    }
+    catch (error) {
+        throw asOptionsError(workflow, given, error);
+    }
 }
 //# sourceMappingURL=run.js.map

package/dist/app/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/app/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/app/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,QAAQ,IAAI,KAAK,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAgB,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAgB,EAChB,IAAY,EACZ,OAAyC,EACzC,KAAe;IAEf,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,KAAK,CAChB;YACE,QAAQ;YACR,KAAK;YACL,UAAU;YACV,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC;YACxD,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,OAAO,CAAC,UAAU;YAC7B,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,EACD,KAAK,CACN,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/app/runs.d.ts

@@ -1,36 +1,8 @@
-import type { RunEvent, RunState } from "../engine/types.js";
+import type { RunEntry, RunState } from "@clemrig/flow";
 import type { Factory } from "../system/factory.js";
-export { UnknownRunError } from "../system/store.js";
-/** A run, or why it cannot be read. */
-export type RunEntry = {
-    id: string;
-    state: RunState;
-} | {
-    id: string;
-    error: string;
-};
-/** The repository's runs in creation order; an unreadable run comes with its error. */
+/** The repository's runs, in creation order; an unreadable run comes with its error. */
 export declare function listRuns(factory: Factory): Promise<RunEntry[]>;
-/** A run as a list shows it; a cost no agent announced is unknown (`null`), not zero. */
-export declare function summarizeRun(state: RunState): {
-    id: string;
-    workflow: string;
-    status: "completed" | "failed" | "running";
-    stage: string;
-    durationMs: number | null;
-    costUsd: number | null;
-    /** Some agent call announced no usage. */
-    partial: boolean;
-    updatedAt: string;
-};
-/** One run's state; an unknown ID is refused. */
+/** One run of the repository; an unknown ID is refused. */
 export declare function loadRun(factory: Factory, id: string): Promise<RunState>;
-/** One run's stage and journal events, in order. */
-export declare function loadRunEvents(factory: Factory, id: string): Promise<RunEvent[]>;
-/**
- * A run's result lines: its workflow's rendering, or its validated data when the
- * workflow left `factory.ts`. A failing rendering becomes the explanation.
- */
+/** A run's result lines: its workflow's rendering, or its validated data when the workflow left `factory.ts`. */
 export declare function presentResult(factory: Factory, state: Readonly<RunState>): string[];
-/** Each correction route's maximum, keyed `<stage>.<outcome>` like a run's counters. */
-export declare function retryMaximums(factory: Factory, workflow: string): Map<string, number>;

package/dist/app/runs.js

@@ -1,66 +1,14 @@
-import { elapsedMs } from "../engine/metrics.js";
-import { presentData } from "../engine/workflow.js";
-import { FileRunStore } from "../system/store.js";
-export { UnknownRunError } from "../system/store.js";
-const message = (error) => error instanceof Error ? error.message : String(error);
-/** The repository's runs in creation order; an unreadable run comes with its error. */
-export async function listRuns(factory) {
-    const entries = [];
-    for (const id of await FileRunStore.list(factory.runsDir))
-        try {
-            entries.push({
-                id,
-                state: await new FileRunStore(factory.runsDir, id).load(),
-            });
-        }
-        catch (error) {
-            entries.push({ id, error: message(error) });
-        }
-    return entries;
+import * as flow from "@clemrig/flow";
+/** The repository's runs, in creation order; an unreadable run comes with its error. */
+export function listRuns(factory) {
+    return flow.listRuns(factory.runsDir);
 }
-/** A run as a list shows it; a cost no agent announced is unknown (`null`), not zero. */
-export function summarizeRun(state) {
-    const usage = state.metrics?.usage;
-    return {
-        id: state.id,
-        workflow: state.workflow,
-        status: state.status,
-        stage: state.stage,
-        durationMs: elapsedMs(state),
-        costUsd: usage?.responses ? usage.costUsd : null,
-        /** Some agent call announced no usage. */
-        partial: Boolean(usage?.missing),
-        updatedAt: state.updatedAt,
-    };
+/** One run of the repository; an unknown ID is refused. */
+export function loadRun(factory, id) {
+    return flow.loadRun(factory.runsDir, id);
 }
-/** One run's state; an unknown ID is refused. */
-export async function loadRun(factory, id) {
-    return new FileRunStore(factory.runsDir, id).load();
-}
-/** One run's stage and journal events, in order. */
-export async function loadRunEvents(factory, id) {
-    return new FileRunStore(factory.runsDir, id).events();
-}
-/**
- * A run's result lines: its workflow's rendering, or its validated data when the
- * workflow left `factory.ts`. A failing rendering becomes the explanation.
- */
+/** A run's result lines: its workflow's rendering, or its validated data when the workflow left `factory.ts`. */
 export function presentResult(factory, state) {
-    try {
-        const workflow = factory.workflows.get(state.workflow);
-        return workflow ? workflow.presentResult(state) : presentData(state);
-    }
-    catch (error) {
-        return [`Result unavailable: ${message(error)}`];
-    }
-}
-/** Each correction route's maximum, keyed `<stage>.<outcome>` like a run's counters. */
-export function retryMaximums(factory, workflow) {
-    const found = new Map();
-    for (const [name, node] of Object.entries(factory.workflows.get(workflow)?.nodes ?? {}))
-        for (const [outcome, edge] of Object.entries(node.on))
-            if (edge && typeof edge === "object")
-                found.set(`${name}.${outcome}`, edge.max);
-    return found;
+    return flow.presentResult(factory.workflows.get(state.workflow), state);
 }
 //# sourceMappingURL=runs.js.map

package/dist/app/runs.js.map

@@ -1 +1 @@
-{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/app/runs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/app/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAItC,wFAAwF;AACxF,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,OAAO,CAAC,OAAgB,EAAE,EAAU;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,aAAa,CAC3B,OAAgB,EAChB,KAAyB;IAEzB,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/application.d.ts

@@ -1,5 +1,5 @@
 /**
- * The command run by the core installed in `.factory/`: the global `factory`
+ * The command run by the factory installed in `.factory/`: the global `factory`
  * calls it with the arguments it received and the `.factory/` it found. This
  * contract only changes with a major version.
  */

package/dist/cli/application.js

@@ -16,7 +16,7 @@ function parsePort(value) {
     return port;
 }
 /**
- * The command run by the core installed in `.factory/`: the global `factory`
+ * The command run by the factory installed in `.factory/`: the global `factory`
  * calls it with the arguments it received and the `.factory/` it found. This
  * contract only changes with a major version.
  */