@clemrig/factory 0.3.0 → 0.4.0

package/dist/domain/verification.js

@@ -0,0 +1,11 @@
+/** The correction sent to the implementing agent: the failed check, its cause and the end of its output. */
+export function failureFeedback(check, cause, output) {
+    const header = `Verification failed: ${check.name} (\`${check.command.join(" ")}\`): ${cause}.`;
+    const tail = output.trim().split("\n").slice(-100).join("\n").slice(-8000);
+    return tail ? `${header} End of its output:\n${tail}` : header;
+}
+/** A duration as the terminal and the pull request show it. */
+export function seconds(durationMs) {
+    return `${Math.round(durationMs / 1000)} s`;
+}
+//# sourceMappingURL=verification.js.map

package/dist/domain/verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../src/domain/verification.ts"],"names":[],"mappings":"AAcA,4GAA4G;AAC5G,MAAM,UAAU,eAAe,CAC7B,KAAoB,EACpB,KAAa,EACb,MAAc;IAEd,MAAM,MAAM,GAAG,wBAAwB,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC;IAChG,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,wBAAwB,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACjE,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,OAAO,CAAC,UAAkB;IACxC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 /**
- * 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.
+ * Public API of a repository's `.factory/`: `defineFactory`, which adapts the
+ * factory's workflows to the repository, and the engine's API to write its own
+ * workflows, `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";
+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, type WorkflowStep, z, } from "@clemrig/flow";
+export { type DefinedFactory, defineFactory } from "./app/define.js";
+export type { FactoryDefinition } from "./domain/definition.js";
+export type { VerifyCommand } from "./domain/verification.js";

package/dist/index.js

@@ -1,7 +1,9 @@
 /**
- * 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.
+ * Public API of a repository's `.factory/`: `defineFactory`, which adapts the
+ * factory's workflows to the repository, and the engine's API to write its own
+ * workflows, `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";
+export { defineFactory } from "./app/define.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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,EAGJ,CAAC,GACF,MAAM,eAAe,CAAC;AACvB,OAAO,EAAuB,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/system/checks.d.ts

@@ -0,0 +1,32 @@
+import type { CheckResult, VerifyCommand } from "../domain/verification.js";
+export type CheckOutcome = {
+    ok: true;
+    durationMs: number;
+} | {
+    ok: false;
+    cause: string;
+    output: string;
+};
+/** Runs one of the repository's checks; a timeout or a command that cannot start fails it, Ctrl-C stops the run. */
+export declare function runCheck(dir: string, check: VerifyCommand): Promise<CheckOutcome>;
+export type ChecksOutcome = {
+    ok: true;
+    passed: CheckResult[];
+} | {
+    ok: false;
+    passed: CheckResult[];
+    check: VerifyCommand;
+    cause: string;
+    output: string;
+};
+/** A check that starts, or passes with its duration. */
+export type CheckProgress = {
+    check: VerifyCommand;
+    status: "started";
+} | {
+    check: VerifyCommand;
+    status: "passed";
+    durationMs: number;
+};
+/** Runs the checks in order, stopping at the first failure. */
+export declare function runChecks(dir: string, checks: VerifyCommand[], progress?: (event: CheckProgress) => void): Promise<ChecksOutcome>;

package/dist/system/checks.js

@@ -0,0 +1,49 @@
+import { ProcessInterruptedError, ProcessTimeoutError, runProcess, } from "@clemrig/flow";
+/** Runs one of the repository's checks; a timeout or a command that cannot start fails it, Ctrl-C stops the run. */
+export async function runCheck(dir, check) {
+    const started = Date.now();
+    try {
+        const result = await runProcess(check.command, dir, check.timeoutMs);
+        if (result.exitCode === 0)
+            return { ok: true, durationMs: Date.now() - started };
+        return {
+            ok: false,
+            cause: `exit code ${result.exitCode}`,
+            output: result.stdout + result.stderr,
+        };
+    }
+    catch (error) {
+        if (error instanceof ProcessInterruptedError)
+            throw error;
+        return {
+            ok: false,
+            cause: error instanceof Error ? error.message : String(error),
+            // What a command wrote before its timeout explains it.
+            output: error instanceof ProcessTimeoutError ? error.stdout + error.stderr : "",
+        };
+    }
+}
+/** Runs the checks in order, stopping at the first failure. */
+export async function runChecks(dir, checks, progress) {
+    const passed = [];
+    for (const check of checks) {
+        progress?.({ check, status: "started" });
+        const outcome = await runCheck(dir, check);
+        if (!outcome.ok)
+            return {
+                ok: false,
+                passed,
+                check,
+                cause: outcome.cause,
+                output: outcome.output,
+            };
+        progress?.({ check, status: "passed", durationMs: outcome.durationMs });
+        passed.push({
+            name: check.name,
+            command: check.command,
+            durationMs: outcome.durationMs,
+        });
+    }
+    return { ok: true, passed };
+}
+//# sourceMappingURL=checks.js.map

package/dist/system/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/system/checks.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,UAAU,GACX,MAAM,eAAe,CAAC;AAOvB,oHAAoH;AACpH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,KAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QACxD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,aAAa,MAAM,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;SACtC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,uBAAuB;YAAE,MAAM,KAAK,CAAC;QAC1D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YAC7D,uDAAuD;YACvD,MAAM,EACJ,KAAK,YAAY,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;SAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAiBD,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,MAAuB,EACvB,QAAyC;IAEzC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,EAAE;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM;gBACN,KAAK;gBACL,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC;QACJ,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/dist/system/factory.d.ts

@@ -1,4 +1,4 @@
-import { type Workflow } from "@clemrig/flow";
+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/`. */
@@ -6,11 +6,13 @@ export interface Factory {
     factoryDir: string;
     runsDir: string;
     workflows: Map<string, Workflow>;
+    /** The factory's own workflows, whose prompts come with this package. */
+    packaged: Set<string>;
 }
 /** 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>;
+/** Imports `.factory/factory.ts` and returns its default export, unchecked. */
+export declare function importFactory(factoryDir: string): Promise<unknown>;
 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>>;
+/** Reads `<name>.md` for each agent stage of the workflow, at every run. */
+export declare function loadPrompts(factory: Factory, workflow: Workflow): Promise<Record<string, string>>;

package/dist/system/factory.js

@@ -1,7 +1,6 @@
 import { readFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
-import { pathToFileURL } from "node:url";
-import { isWorkflow } from "@clemrig/flow";
+import { fileURLToPath, pathToFileURL } from "node:url";
 /** A factory without workflows, to read runs when `factory.ts` cannot load. */
 export function emptyFactory(factoryDir) {
     return {
@@ -9,23 +8,13 @@ export function emptyFactory(factoryDir) {
         factoryDir,
         runsDir: join(factoryDir, "runs"),
         workflows: new Map(),
+        packaged: new Set(),
     };
 }
-/** Imports `.factory/factory.ts`, whose default export lists the repository's workflows. */
-export async function loadFactory(factoryDir) {
+/** Imports `.factory/factory.ts` and returns its default export, unchecked. */
+export async function importFactory(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 };
+    return module.default;
 }
 export function workflowOf(factory, name) {
     const workflow = factory.workflows.get(name);
@@ -33,14 +22,25 @@ export function workflowOf(factory, name) {
         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) {
+/** Both `src/system/` and `dist/system/` sit two levels below the package root. */
+const packageRoot = fileURLToPath(new URL("../../", import.meta.url));
+/**
+ * Where a workflow's prompts are: `prompts/<workflow>/` of this package for the
+ * factory's own, `.factory/workflows/<workflow>/prompts/` for the repository's.
+ */
+function promptsDir(factory, workflow) {
+    return factory.packaged.has(workflow.name)
+        ? join(packageRoot, "prompts", workflow.name)
+        : join(factory.factoryDir, "workflows", workflow.name, "prompts");
+}
+/** Reads `<name>.md` for each agent stage of the workflow, at every run. */
+export async function loadPrompts(factory, 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`);
+        const file = join(promptsDir(factory, workflow), `${name}.md`);
         let text;
         try {
             text = await readFile(file, "utf8");

package/dist/system/factory.js.map

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

package/dist/system/git.d.ts

@@ -0,0 +1,25 @@
+/** A branch's full reference: a tag of the same name never answers for it. */
+export declare function branchRef(branch: string): string;
+/** The full reference of `origin`'s copy of a branch. */
+export declare function remoteRef(branch: string): string;
+/** The branch `origin/HEAD` points to, read from its full reference: a tag never shortens it. */
+export declare function defaultBranch(dir: string): Promise<string>;
+/** The repository's Git directory, where Git keeps what belongs to this working tree. */
+export declare function gitDir(dir: string): Promise<string>;
+/** The files under `path` in a branch or commit, relative to the repository. */
+export declare function filesIn(dir: string, ref: string, path: string): Promise<string[]>;
+export declare function currentBranch(dir: string): Promise<string>;
+/** Modified, staged or untracked files, in the whole tree or under a path. */
+export declare function hasChanges(dir: string, path?: string): Promise<boolean>;
+export declare function fetchBranch(dir: string, branch: string): Promise<void>;
+export declare function commitOf(dir: string, ref: string): Promise<string>;
+/** Switches to a branch; `from` creates it at that commit, replacing a branch of that name. */
+export declare function switchTo(dir: string, branch: string, from?: string): Promise<void>;
+/** Commits the given paths, or every change; returns the new commit. */
+export declare function commit(dir: string, message: string, paths?: string[]): Promise<string>;
+/** Every change since a commit, new files included: stages them all, then diffs the index. */
+export declare function stagedDiff(dir: string, since: string): Promise<{
+    text: string;
+    truncated: boolean;
+}>;
+export declare function forcePush(dir: string, branch: string): Promise<void>;

package/dist/system/git.js

@@ -0,0 +1,73 @@
+import { runProcess } from "@clemrig/flow";
+/** Runs git in the repository; a failure carries git's own message. */
+async function git(dir, args, timeoutMs = 60_000) {
+    const result = await runProcess(["git", ...args], dir, timeoutMs);
+    if (result.exitCode !== 0)
+        throw new Error(`git ${args.join(" ")} failed: ${result.stderr.trim() || result.stdout.trim()}`);
+    return result;
+}
+async function output(dir, args) {
+    return (await git(dir, args)).stdout.trim();
+}
+/** A branch's full reference: a tag of the same name never answers for it. */
+export function branchRef(branch) {
+    return `refs/heads/${branch}`;
+}
+/** The full reference of `origin`'s copy of a branch. */
+export function remoteRef(branch) {
+    return `refs/remotes/origin/${branch}`;
+}
+/** The branch `origin/HEAD` points to, read from its full reference: a tag never shortens it. */
+export async function defaultBranch(dir) {
+    return (await output(dir, ["symbolic-ref", "refs/remotes/origin/HEAD"])).replace(/^refs\/remotes\/origin\//, "");
+}
+/** The repository's Git directory, where Git keeps what belongs to this working tree. */
+export function gitDir(dir) {
+    return output(dir, ["rev-parse", "--absolute-git-dir"]);
+}
+/** The files under `path` in a branch or commit, relative to the repository. */
+export async function filesIn(dir, ref, path) {
+    return (await output(dir, ["ls-tree", "-r", "--name-only", ref, "--", path]))
+        .split("\n")
+        .filter(Boolean);
+}
+export function currentBranch(dir) {
+    return output(dir, ["branch", "--show-current"]);
+}
+/** Modified, staged or untracked files, in the whole tree or under a path. */
+export async function hasChanges(dir, path) {
+    return ((await output(dir, [
+        "status",
+        "--porcelain",
+        // Every untracked file, whatever status.showUntrackedFiles says.
+        "--untracked-files=all",
+        ...(path ? ["--", path] : []),
+    ])) !== "");
+}
+export async function fetchBranch(dir, branch) {
+    await git(dir, ["fetch", "origin", `+${branchRef(branch)}:${remoteRef(branch)}`], 120_000);
+}
+export function commitOf(dir, ref) {
+    return output(dir, ["rev-parse", ref]);
+}
+/** Switches to a branch; `from` creates it at that commit, replacing a branch of that name. */
+export async function switchTo(dir, branch, from) {
+    await git(dir, ["switch", ...(from ? ["-C", branch, from] : [branch])]);
+}
+/** Commits the given paths, or every change; returns the new commit. */
+export async function commit(dir, message, paths) {
+    await git(dir, ["add", ...(paths ? ["--", ...paths] : ["-A"])]);
+    await git(dir, ["commit", "-m", message, ...(paths ? ["--", ...paths] : [])]);
+    return commitOf(dir, "HEAD");
+}
+/** Every change since a commit, new files included: stages them all, then diffs the index. */
+export async function stagedDiff(dir, since) {
+    await git(dir, ["add", "-A"]);
+    const result = await git(dir, ["diff", "--cached", since]);
+    return { text: result.stdout, truncated: result.stdoutTruncated };
+}
+export async function forcePush(dir, branch) {
+    const ref = branchRef(branch);
+    await git(dir, ["push", "--force", "-u", "origin", `${ref}:${ref}`], 120_000);
+}
+//# sourceMappingURL=git.js.map

package/dist/system/git.js.map

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

package/dist/system/github.d.ts

@@ -0,0 +1,8 @@
+export declare function isAuthenticated(dir: string): Promise<boolean>;
+/** Updates the branch's open pull request, or opens one; returns its URL. */
+export declare function openPullRequest(dir: string, pullRequest: {
+    base: string;
+    head: string;
+    title: string;
+    body: string;
+}): Promise<string>;

package/dist/system/github.js

@@ -0,0 +1,52 @@
+import { runProcess } from "@clemrig/flow";
+/** Runs gh in the repository; its output is never journaled, as it may describe the account. */
+async function gh(dir, args, stdin) {
+    const result = await runProcess(["gh", ...args], dir, 60_000, undefined, stdin);
+    if (result.exitCode !== 0)
+        throw new Error(`gh ${args.slice(0, 2).join(" ")} failed: ${result.stderr.trim()}`);
+    return result.stdout.trim();
+}
+export async function isAuthenticated(dir) {
+    const result = await runProcess(["gh", "auth", "status"], dir, 60_000);
+    return result.exitCode === 0;
+}
+/** Updates the branch's open pull request, or opens one; returns its URL. */
+export async function openPullRequest(dir, pullRequest) {
+    const { base, head, title, body } = pullRequest;
+    const open = JSON.parse(await gh(dir, [
+        "pr",
+        "list",
+        "--head",
+        head,
+        "--state",
+        "open",
+        "--json",
+        "number,url",
+    ]));
+    const existing = open[0];
+    if (existing) {
+        await gh(dir, [
+            "pr",
+            "edit",
+            String(existing.number),
+            "--title",
+            title,
+            "--body-file",
+            "-",
+        ], body);
+        return existing.url;
+    }
+    return gh(dir, [
+        "pr",
+        "create",
+        "--base",
+        base,
+        "--head",
+        head,
+        "--title",
+        title,
+        "--body-file",
+        "-",
+    ], body);
+}
+//# sourceMappingURL=github.js.map

package/dist/system/github.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/system/github.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,gGAAgG;AAChG,KAAK,UAAU,EAAE,CACf,GAAW,EACX,IAAc,EACd,KAAc;IAEd,MAAM,MAAM,GAAG,MAAM,UAAU,CAC7B,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,EACf,GAAG,EACH,MAAM,EACN,SAAS,EACT,KAAK,CACN,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CACnE,CAAC;IACJ,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACvE,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,WAAwE;IAExE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CACrB,MAAM,EAAE,CAAC,GAAG,EAAE;QACZ,IAAI;QACJ,MAAM;QACN,QAAQ;QACR,IAAI;QACJ,SAAS;QACT,MAAM;QACN,QAAQ;QACR,YAAY;KACb,CAAC,CACkC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,EAAE,CACN,GAAG,EACH;YACE,IAAI;YACJ,MAAM;YACN,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvB,SAAS;YACT,KAAK;YACL,aAAa;YACb,GAAG;SACJ,EACD,IAAI,CACL,CAAC;QACF,OAAO,QAAQ,CAAC,GAAG,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,CACP,GAAG,EACH;QACE,IAAI;QACJ,QAAQ;QACR,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,SAAS;QACT,KAAK;QACL,aAAa;QACb,GAAG;KACJ,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/system/issues.d.ts

@@ -0,0 +1,24 @@
+export type ArtifactKind = "issue" | "spec" | "plan";
+/** Where the issues are, relative to the repository. */
+export declare const issuesPath: string;
+/** `.factory/issues/<slug>/<kind>.md`, relative to the repository: the only place that names these paths. */
+export declare function artifactPath(slug: string, kind: ArtifactKind): string;
+/** An issue's folder as it is in the working tree. */
+export interface IssueFolder {
+    slug: string;
+    /** Its `issue.md`, when it has one. */
+    issue?: string;
+    /** Why its `issue.md` cannot be read. */
+    unreadable?: string;
+    hasSpec: boolean;
+    /** When one of its files last changed, as an ISO date. */
+    changedAt: string;
+}
+/** Every folder of `.factory/issues/`; none before the first issue. */
+export declare function listIssueFolders(repository: string): Promise<IssueFolder[]>;
+export declare function writeArtifact(repository: string, slug: string, kind: ArtifactKind, text: string): Promise<string>;
+export declare function hasArtifact(repository: string, slug: string, kind: ArtifactKind): Promise<boolean>;
+/** The artifact's text, or nothing when the issue has none. */
+export declare function readArtifact(repository: string, slug: string, kind: ArtifactKind): Promise<string | undefined>;
+/** A draft handed over by an agent, wherever it wrote it. */
+export declare function readDraft(path: string): Promise<string>;

package/dist/system/issues.js

@@ -0,0 +1,66 @@
+import { access, mkdir, readdir, readFile, stat, writeFile, } from "node:fs/promises";
+import { dirname, join } from "node:path";
+/** Where the issues are, relative to the repository. */
+export const issuesPath = join(".factory", "issues");
+/** `.factory/issues/<slug>/<kind>.md`, relative to the repository: the only place that names these paths. */
+export function artifactPath(slug, kind) {
+    return join(issuesPath, slug, `${kind}.md`);
+}
+/** Every folder of `.factory/issues/`; none before the first issue. */
+export async function listIssueFolders(repository) {
+    const root = join(repository, issuesPath);
+    const entries = await readdir(root, { withFileTypes: true }).catch((error) => {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    });
+    const folders = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const files = await readdir(join(root, entry.name));
+        // A folder without its files is not an issue (an abandoned one, say).
+        if (!["issue.md", "spec.md", "plan.md"].some((file) => files.includes(file)))
+            continue;
+        const changes = await Promise.all([".", ...files].map((file) => stat(join(root, entry.name, file)).then(({ mtimeMs }) => mtimeMs, 
+        // An editor's temporary file may go between the listing and now.
+        (error) => {
+            if (error.code === "ENOENT")
+                return 0;
+            throw error;
+        })));
+        // One unreadable issue.md leaves the other issues readable.
+        const issue = await readArtifact(repository, entry.name, "issue").then((text) => ({ text }), (error) => ({
+            error: error instanceof Error ? error.message : String(error),
+        }));
+        folders.push({
+            slug: entry.name,
+            ...("text" in issue
+                ? { issue: issue.text }
+                : { unreadable: issue.error }),
+            hasSpec: files.includes("spec.md"),
+            changedAt: new Date(Math.max(...changes)).toISOString(),
+        });
+    }
+    return folders;
+}
+export async function writeArtifact(repository, slug, kind, text) {
+    const path = artifactPath(slug, kind);
+    await mkdir(dirname(join(repository, path)), { recursive: true });
+    await writeFile(join(repository, path), text);
+    return path;
+}
+export async function hasArtifact(repository, slug, kind) {
+    return access(join(repository, artifactPath(slug, kind))).then(() => true, () => false);
+}
+/** The artifact's text, or nothing when the issue has none. */
+export async function readArtifact(repository, slug, kind) {
+    if (!(await hasArtifact(repository, slug, kind)))
+        return undefined;
+    return readFile(join(repository, artifactPath(slug, kind)), "utf8");
+}
+/** A draft handed over by an agent, wherever it wrote it. */
+export function readDraft(path) {
+    return readFile(path, "utf8");
+}
+//# sourceMappingURL=issues.js.map

package/dist/system/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/system/issues.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,SAAS,GACV,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAI1C,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAErD,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAkB;IAC3D,OAAO,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AAC9C,CAAC;AAcD,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAChE,CAAC,KAA4B,EAAE,EAAE;QAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC;IACd,CAAC,CACF,CAAC;IACF,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACpD,sEAAsE;QACtE,IACE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAExE,SAAS;QACX,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CACrC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO;QACxB,iEAAiE;QACjE,CAAC,KAA4B,EAAE,EAAE;YAC/B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC;YACtC,MAAM,KAAK,CAAC;QACd,CAAC,CACF,CACF,CACF,CAAC;QACF,4DAA4D;QAC5D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,CACpE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EACpB,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC;YACnB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CACH,CAAC;QACF,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,MAAM,IAAI,KAAK;gBACjB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;gBACvB,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;YAClC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,EAAE;SACxD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,IAAY,EACZ,IAAkB,EAClB,IAAY;IAEZ,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkB,EAClB,IAAY,EACZ,IAAkB;IAElB,OAAO,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAC5D,GAAG,EAAE,CAAC,IAAI,EACV,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAAkB,EAClB,IAAY,EACZ,IAAkB;IAElB,IAAI,CAAC,CAAC,MAAM,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACtE,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/system/lock.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runs `work` while holding the lock file `path`, created atomically: two
+ * processes never hold it together. A holder is awaited up to `waitMs`; a lock
+ * still there after that, left by a process that stopped, is named in the error.
+ */
+export declare function exclusively<T>(path: string, work: () => Promise<T>, waitMs?: number): Promise<T>;
+/** Runs `work` alone among the factory's runs of this working tree: the lock lives in its Git directory. */
+export declare function withTreeLock<T>(dir: string, work: () => Promise<T>): Promise<T>;

package/dist/system/lock.js

@@ -0,0 +1,35 @@
+import { rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { gitDir } from "./git.js";
+/**
+ * Runs `work` while holding the lock file `path`, created atomically: two
+ * processes never hold it together. A holder is awaited up to `waitMs`; a lock
+ * still there after that, left by a process that stopped, is named in the error.
+ */
+export async function exclusively(path, work, waitMs = 10_000) {
+    const until = Date.now() + waitMs;
+    for (;;) {
+        try {
+            await writeFile(path, `${process.pid}\n`, { flag: "wx" });
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            if (Date.now() >= until)
+                throw new Error(`${path} has been held for ${Math.round(waitMs / 1000)} s: if no implement run is starting, remove it`);
+            await new Promise((resolve) => setTimeout(resolve, 50));
+        }
+    }
+    try {
+        return await work();
+    }
+    finally {
+        await rm(path, { force: true });
+    }
+}
+/** Runs `work` alone among the factory's runs of this working tree: the lock lives in its Git directory. */
+export async function withTreeLock(dir, work) {
+    return exclusively(join(await gitDir(dir), "factory-implement.lock"), work);
+}
+//# sourceMappingURL=lock.js.map

package/dist/system/lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/system/lock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,IAAsB,EACtB,MAAM,GAAG,MAAM;IAEf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IAClC,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,MAAM;QACR,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YACpE,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAK;gBACrB,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,sBAAsB,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,gDAAgD,CACvG,CAAC;YACJ,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,IAAsB;IAEtB,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,wBAAwB,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC"}

package/dist/system/templates.d.ts

@@ -1,6 +1,7 @@
 /**
  * Creates `.factory/` in `cwd` from the package's templates, its `package.json`
- * pinned to this factory version. An existing `.factory/` is refused untouched.
+ * pinned to this factory version, and the `issue` skill. An existing
+ * `.factory/` or skill is refused, with nothing written.
  */
 export declare function createFromTemplates(cwd: string): Promise<{
     factoryDir: string;