@clemrig/factory 0.2.1 → 0.4.0

package/dist/domain/spec.js

@@ -0,0 +1,118 @@
+const sectionHeadings = [
+    "Objective",
+    "Scope",
+    "Out of scope",
+    "Acceptance criteria",
+    "Constraints",
+];
+/** Reads spec.md: a `# ` title, then exactly the five sections, in order. */
+export function parseSpec(text) {
+    const [first = "", ...lines] = text.trim().split(/\r?\n/);
+    const title = /^# (.*)$/.exec(first)?.[1]?.trim() ?? "";
+    const preamble = [];
+    const headings = [];
+    const sections = new Map();
+    let current = preamble;
+    for (const line of lines) {
+        const heading = /^## (.*)$/.exec(line)?.[1]?.trim();
+        if (heading === undefined)
+            current.push(line);
+        else {
+            current = [];
+            headings.push(heading);
+            sections.set(heading, current);
+        }
+    }
+    const body = (heading) => (sections.get(heading) ?? []).join("\n").trim();
+    const { criteria, problems: criteriaProblems } = parseCriteria(sections.get("Acceptance criteria") ?? []);
+    const problems = [
+        ...(title ? [] : ["The first line must be a title: # <Title>"]),
+        ...(preamble.join("").trim()
+            ? ["Unexpected text before the first section"]
+            : []),
+        ...sectionProblems(headings),
+        ...sectionHeadings
+            .filter((heading) => sections.has(heading) && !body(heading))
+            .map((heading) => `Empty section: ## ${heading}`),
+        ...criteriaProblems,
+    ];
+    if (problems.length > 0)
+        return { ok: false, problems };
+    return {
+        ok: true,
+        value: {
+            title,
+            objective: body("Objective"),
+            scope: body("Scope"),
+            outOfScope: body("Out of scope"),
+            criteria,
+            constraints: body("Constraints"),
+        },
+    };
+}
+/** Exactly the expected headings, each once, in order. */
+function sectionProblems(headings) {
+    const unknown = headings.filter((heading) => !sectionHeadings.includes(heading));
+    const duplicate = sectionHeadings.filter((heading) => headings.indexOf(heading) !== headings.lastIndexOf(heading));
+    const missing = sectionHeadings.filter((heading) => !headings.includes(heading));
+    const problems = [
+        ...[...new Set(unknown)].map((heading) => `Unknown section: ## ${heading}`),
+        ...duplicate.map((heading) => `Duplicate section: ## ${heading}`),
+        ...missing.map((heading) => `Missing section: ## ${heading}`),
+    ];
+    if (problems.length === 0 &&
+        headings.join("\n") !== sectionHeadings.join("\n"))
+        problems.push(`Sections must appear in this order: ${sectionHeadings.join(", ")}`);
+    return problems;
+}
+/** `- AC<n>: <text>` items numbered from 1; an indented line continues the item above it. */
+function parseCriteria(lines) {
+    const criteria = [];
+    const problems = [];
+    let open;
+    const close = () => {
+        if (open && !open.text)
+            problems.push(`Acceptance criteria: ${open.id} is empty`);
+        open = undefined;
+    };
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const item = /^- (AC\d+):(.*)$/.exec(line);
+        if (item) {
+            close();
+            const [, id = "", text = ""] = item;
+            const expected = `AC${criteria.length + 1}`;
+            if (id !== expected)
+                problems.push(`Acceptance criteria: expected ${expected}, found ${id}`);
+            open = { id, text: text.trim() };
+            criteria.push(open);
+        }
+        else if (open && /^\s/.test(line))
+            open.text = `${open.text} ${line.trim()}`.trim();
+        else {
+            close();
+            problems.push(`Acceptance criteria: unexpected line "${line.trim()}" (write "- AC<n>: <criterion>")`);
+        }
+    }
+    close();
+    return { criteria, problems };
+}
+/** What is wrong with the criteria a response cites: all of the spec's, no other, and each once if required. */
+export function citationProblem(cited, criteria, once = false) {
+    const ids = criteria.map((criterion) => criterion.id);
+    const missing = ids.filter((id) => !cited.includes(id));
+    const unknown = [...new Set(cited.filter((id) => !ids.includes(id)))];
+    const repeated = once
+        ? [...new Set(cited.filter((id, index) => cited.indexOf(id) !== index))]
+        : [];
+    const problems = [
+        ...(missing.length > 0 ? [`missing ${missing.join(", ")}`] : []),
+        ...(unknown.length > 0 ? [`unknown ${unknown.join(", ")}`] : []),
+        ...(repeated.length > 0 ? [`repeated ${repeated.join(", ")}`] : []),
+    ];
+    return problems.length > 0
+        ? `Acceptance criteria: ${problems.join("; ")}`
+        : undefined;
+}
+//# sourceMappingURL=spec.js.map

package/dist/domain/spec.js.map

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

package/dist/domain/verification.d.ts

@@ -0,0 +1,16 @@
+/** A command of the repository that must succeed, as its definition declares it. */
+export interface VerifyCommand {
+    name: string;
+    command: string[];
+    timeoutMs: number;
+}
+/** A check that passed, as the pull request reports it. */
+export interface CheckResult {
+    name: string;
+    command: string[];
+    durationMs: number;
+}
+/** The correction sent to the implementing agent: the failed check, its cause and the end of its output. */
+export declare function failureFeedback(check: VerifyCommand, cause: string, output: string): string;
+/** A duration as the terminal and the pull request show it. */
+export declare function seconds(durationMs: number): string;

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>;