@clemrig/factory 0.0.0-stage → 0.2.0

package/dist/system/factory.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { isWorkflow } from "@clemrig/flow";
+/** A factory without workflows, to read runs when `factory.ts` cannot load. */
+export function emptyFactory(factoryDir) {
+    return {
+        dir: dirname(factoryDir),
+        factoryDir,
+        runsDir: join(factoryDir, "runs"),
+        workflows: new Map(),
+    };
+}
+/** Imports `.factory/factory.ts`, whose default export lists the repository's workflows. */
+export async function loadFactory(factoryDir) {
+    const module = (await import(pathToFileURL(join(factoryDir, "factory.ts")).href));
+    const exported = module.default;
+    if (!Array.isArray(exported))
+        throw new Error("factory.ts must export default an array of defineWorkflow(…) results");
+    const workflows = new Map();
+    for (const workflow of exported) {
+        if (!isWorkflow(workflow))
+            throw new Error("factory.ts must export default an array of defineWorkflow(…) results");
+        if (workflows.has(workflow.name))
+            throw new Error(`Duplicate workflow ${workflow.name} in factory.ts`);
+        workflows.set(workflow.name, workflow);
+    }
+    return { ...emptyFactory(factoryDir), workflows };
+}
+export function workflowOf(factory, name) {
+    const workflow = factory.workflows.get(name);
+    if (!workflow)
+        throw new Error(`Unknown workflow ${name}; workflows: ${[...factory.workflows.keys()].join(", ") || "none"}`);
+    return workflow;
+}
+/** Reads `workflows/<workflow>/prompts/<name>.md` for each agent stage of the workflow, at every run. */
+export async function loadPrompts(factoryDir, workflow) {
+    const prompts = {};
+    const problems = [];
+    for (const { prompt: name } of Object.values(workflow.agents)) {
+        if (Object.hasOwn(prompts, name))
+            continue;
+        const file = join(factoryDir, "workflows", workflow.name, "prompts", `${name}.md`);
+        let text;
+        try {
+            text = await readFile(file, "utf8");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            problems.push(`Missing prompt: ${file}`);
+            continue;
+        }
+        if (!text.trim())
+            problems.push(`Empty prompt: ${file}`);
+        prompts[name] = text.trimEnd();
+    }
+    if (problems.length)
+        throw new Error(problems.join("; "));
+    return prompts;
+}
+//# sourceMappingURL=factory.js.map

package/dist/system/factory.js.map

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

package/dist/system/templates.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates `.factory/` in `cwd` from the package's templates, its `package.json`
+ * pinned to this factory version. An existing `.factory/` is refused untouched.
+ */
+export declare function createFromTemplates(cwd: string): Promise<{
+    factoryDir: string;
+    version: string;
+}>;

package/dist/system/templates.js

@@ -0,0 +1,30 @@
+import { cp, mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Both `src/system/` and `dist/system/` sit two levels below the package root. */
+const root = new URL("../../", import.meta.url);
+/**
+ * Creates `.factory/` in `cwd` from the package's templates, its `package.json`
+ * pinned to this factory version. An existing `.factory/` is refused untouched.
+ */
+export async function createFromTemplates(cwd) {
+    const factoryDir = join(cwd, ".factory");
+    try {
+        await mkdir(factoryDir);
+    }
+    catch (error) {
+        if (error.code === "EEXIST")
+            throw new Error(`${factoryDir} already exists`);
+        throw error;
+    }
+    const { version } = JSON.parse(await readFile(new URL("package.json", root), "utf8"));
+    await cp(new URL("templates/init/", root), factoryDir, { recursive: true });
+    // npm pack drops files named .gitignore: the template has no dot.
+    await rename(join(factoryDir, "gitignore"), join(factoryDir, ".gitignore"));
+    await writeFile(join(factoryDir, "package.json"), `${JSON.stringify({
+        private: true,
+        type: "module",
+        dependencies: { "@clemrig/factory": version },
+    }, null, 2)}\n`);
+    return { factoryDir, version };
+}
+//# sourceMappingURL=templates.js.map

package/dist/system/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/system/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,mFAAmF;AACnF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW;IAEX,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,iBAAiB,CAAC,CAAC;QAClD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAC5B,MAAM,QAAQ,CAAC,IAAI,GAAG,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAC/B,CAAC;IACzB,MAAM,EAAE,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,kEAAkE;IAClE,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAC5E,MAAM,SAAS,CACb,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,EAChC,GAAG,IAAI,CAAC,SAAS,CACf;QACE,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE;KAC9C,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CACN,CAAC;IACF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@clemrig/factory",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Write agent workflows in TypeScript inside any repository, run them in the terminal and watch them in a local dashboard",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clementchesneau/clemrig-factory-v2.git",
+    "directory": "packages/factory"
+  },
+  "type": "module",
+  "bin": {
+    "factory": "dist/main.js"
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/index.js"
+    },
+    "./cli": {
+      "default": "./dist/cli/application.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@clemrig/flow": "0.1.0",
+    "@clemrig/flow-ui": "0.1.0"
+  }
+}

package/templates/init/factory.ts

@@ -0,0 +1,4 @@
+import ask from "./workflows/ask/index.ts";
+
+/** The workflows of this repository, run with `factory run <name>`. */
+export default [ask];

package/templates/init/gitignore

@@ -0,0 +1,3 @@
+node_modules/
+runs/
+.env

package/templates/init/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true,
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "erasableSyntaxOnly": true,
+    "skipLibCheck": true
+  }
+}

package/templates/init/workflows/ask/index.ts

@@ -0,0 +1,57 @@
+import {
+  agent,
+  defineWorkflow,
+  END,
+  node,
+  pick,
+  retry,
+  runProcess,
+  schemaGate,
+  step,
+  z,
+} from "@clemrig/factory";
+
+const answer = z.strictObject({ answer: z.string().min(1) });
+
+/** Answers a question about this repository from its recent commits. */
+export default defineWorkflow({
+  name: "ask",
+  input: z.object({ question: z.string().min(1) }),
+  initial: "commits",
+  nodes: {
+    // CODE: deterministic work in the repository.
+    commits: node(
+      step(async ({ dir }) => {
+        const log = await runProcess(
+          ["git", "log", "--oneline", "-n", "10"],
+          dir,
+          30_000,
+        );
+        if (log.exitCode !== 0)
+          throw new Error(`git log failed: ${log.stderr.trim()}`);
+        return { commits: log.stdout.trim().split("\n").filter(Boolean) };
+      }),
+      { ok: "answer" },
+    ),
+    // AGENT: prompts/answer.md, with the question and the commits as context.
+    // Read-only by default: its tools can read the repository, not change it.
+    answer: node(
+      agent({
+        profile: {
+          runtime: "claude-code",
+          model: "claude-sonnet-5-5",
+          thinking: "low",
+          tools: ["Read", "Grep", "Glob"],
+        },
+        schema: answer,
+        context: pick("input", "commits"),
+      }),
+      { ok: "check" },
+    ),
+    // GATE: an invalid answer goes back to the agent with feedback, at most 3 times.
+    check: node(schemaGate({ schema: answer, into: "answer" }), {
+      ok: END,
+      invalid: retry("answer", 3),
+    }),
+  },
+});

package/templates/init/workflows/ask/prompts/answer.md

@@ -0,0 +1,7 @@
+You answer the operator's question about this repository.
+
+- The context holds the question (`input.question`) and the ten most recent commits (`commits`).
+- Read files with your tools when the commits are not enough.
+- Answer in a few sentences, in the language of `input.question`, whatever language the rest of the context suggests.
+- When the context holds `feedback`, your previous answer was refused: correct what it describes.
+- Return `{"answer": "…"}`.