@clemrig/factory 0.18.3 → 0.20.0

package/dist/domain/review-page.js

@@ -0,0 +1,200 @@
+import { z } from "@clemrig/flow";
+import { diffExcerpt } from "./diff.js";
+import { isBlocking, } from "./review.js";
+const finding = ({ nature, file, summary, }) => ({
+    nature,
+    blocking: isBlocking(nature),
+    ...(file ? { file } : {}),
+    summary,
+});
+const count = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/** The decisions on what the review left: its non-blocking findings, and what the operator delivered open. */
+function reviewDecisions(facts, criteria) {
+    const { review, acceptedReview } = facts;
+    const nonBlocking = review.findings.filter(({ nature }) => !isBlocking(nature));
+    const unmet = acceptedReview
+        ? criteria.filter(({ status }) => status === "not_met")
+        : [];
+    const blocking = acceptedReview
+        ? review.findings.filter(({ nature }) => isBlocking(nature))
+        : [];
+    return [
+        ...(unmet.length + blocking.length > 0
+            ? [
+                {
+                    id: "open",
+                    kind: "open",
+                    title: `Delivered by the operator with ${[
+                        ...(unmet.length > 0
+                            ? [count(unmet.length, "unmet criterion", "unmet criteria")]
+                            : []),
+                        ...(blocking.length > 0
+                            ? [count(blocking.length, "blocking finding")]
+                            : []),
+                    ].join(" and ")}`,
+                    advice: "revise",
+                    recommendation: "The review did not approve them: have them fixed, or merge knowing they stay open.",
+                    why: "The run was resumed to deliver the change as its last review left it.",
+                    findings: blocking.map(finding),
+                    unmet,
+                },
+            ]
+            : []),
+        ...(nonBlocking.length > 0
+            ? [
+                {
+                    id: "non-blocking",
+                    kind: "non_blocking",
+                    title: `${count(nonBlocking.length, "non-blocking finding")} left by the review`,
+                    advice: "accept",
+                    recommendation: "The review approved the change without them: merge, and note them for later.",
+                    why: "None blocks the change; whether they go with it, or come later, is yours to decide.",
+                    findings: nonBlocking.map(finding),
+                },
+            ]
+            : []),
+    ];
+}
+/** The page's data, from the run that delivered the change. */
+export function reviewPage(facts) {
+    const { description, review, plan, implementation } = facts;
+    const judged = new Map(review.criteria.map((c) => [c.id, c]));
+    const criteria = facts.criteria.map(({ id, text }) => ({
+        id,
+        text,
+        status: judged.get(id)?.status ?? "not_met",
+        evidence: judged.get(id)?.evidence ?? "",
+    }));
+    const byPath = new Map(facts.files.map((file) => [file.path, file]));
+    const shown = (path) => {
+        const file = byPath.get(path);
+        return file ? [{ ...file, url: facts.fileUrl(path) }] : [];
+    };
+    const grouped = new Set(description.guide.groups.flatMap(({ files }) => files));
+    const others = facts.files.filter(({ path }) => !grouped.has(path));
+    const screenshots = description.screenshots.map(({ file, caption }) => ({
+        file,
+        caption,
+        url: facts.screenshotUrl(file),
+    }));
+    const interpretations = plan.interpretations ?? [];
+    // The interpretations and deviations a decision shows, by position.
+    const used = {
+        interpretation: new Set(),
+        deviation: new Set(),
+    };
+    const sourceOf = (id) => {
+        if (id === undefined)
+            return undefined;
+        const kind = id.startsWith("I") ? "interpretation" : "deviation";
+        const position = Number(id.slice(1)) - 1;
+        const text = (kind === "interpretation" ? interpretations : implementation.deviations)[position];
+        if (text === undefined)
+            return undefined;
+        used[kind].add(position);
+        return { kind, text };
+    };
+    const decisions = (description.decisions ?? []).map((decision, index) => {
+        const { visual } = decision;
+        const source = sourceOf(decision.source);
+        const excerpt = visual?.kind === "diff" && visual.file && visual.from && visual.to
+            ? diffExcerpt(facts.diff, visual.file, visual.from, visual.to)
+            : undefined;
+        const drawn = visual?.kind === "reading" && visual.spec && visual.read
+            ? { kind: "reading", spec: visual.spec, read: visual.read }
+            : visual?.kind === "diff" && visual.file && excerpt
+                ? { kind: "diff", file: visual.file, content: excerpt }
+                : visual?.kind === "screenshots" && visual.files
+                    ? {
+                        kind: "screenshots",
+                        items: screenshots.filter(({ file }) => visual.files?.includes(file)),
+                    }
+                    : visual?.kind === "list" && visual.items
+                        ? { kind: "list", items: visual.items }
+                        : undefined;
+        return {
+            id: `decision-${index + 1}`,
+            kind: decision.kind,
+            title: decision.title,
+            ...(decision.criterion ? { criterion: decision.criterion } : {}),
+            advice: decision.advice,
+            recommendation: decision.recommendation,
+            why: decision.why,
+            ...(source ? { source } : {}),
+            ...(decision.file
+                ? { file: { path: decision.file, url: facts.fileUrl(decision.file) } }
+                : {}),
+            ...(drawn ? { visual: drawn } : {}),
+        };
+    });
+    const reviews = facts.reviews ?? [review];
+    return {
+        run: facts.run,
+        title: facts.title,
+        objective: facts.objective,
+        pullRequest: {
+            url: facts.pullRequest,
+            number: Number(/\/pull\/(\d+)/.exec(facts.pullRequest)?.[1] ?? 0),
+        },
+        links: facts.links,
+        danger: description.danger,
+        changes: description.changes,
+        visuals: description.visuals,
+        screenshots,
+        ...(description.noScreenshots
+            ? { noScreenshots: description.noScreenshots }
+            : {}),
+        guide: {
+            start: {
+                ...description.guide.start,
+                url: facts.fileUrl(description.guide.start.file),
+            },
+            groups: [
+                ...description.guide.groups.map(({ title, files }) => ({
+                    title,
+                    files: files.flatMap(shown),
+                })),
+                ...(others.length > 0
+                    ? [
+                        {
+                            title: description.guide.groups.length > 0 ? "Other files" : "Files",
+                            files: others.flatMap(({ path }) => shown(path)),
+                        },
+                    ]
+                    : []),
+            ],
+        },
+        rounds: reviews.map(({ criteria: judgedCriteria, findings, resolved = [] }) => ({
+            met: judgedCriteria.filter(({ status }) => status === "met").length,
+            total: facts.criteria.length,
+            blocking: findings.filter(({ nature }) => isBlocking(nature)).length,
+            nonBlocking: findings.filter(({ nature }) => !isBlocking(nature))
+                .length,
+            resolved,
+        })),
+        criteria,
+        checks: facts.checks.map(({ name, durationMs }) => ({ name, durationMs })),
+        skippedChecks: facts.skippedChecks,
+        decisions: [...decisions, ...reviewDecisions(facts, criteria)],
+        manualChecks: (description.manualChecks ?? []).map((check, index) => ({
+            id: `check-${index + 1}`,
+            ...check,
+        })),
+        assumptions: plan.risks,
+        otherInterpretations: interpretations.filter((_, index) => !used.interpretation.has(index)),
+        otherDeviations: implementation.deviations.filter((_, index) => !used.deviation.has(index)),
+    };
+}
+const answer = z.enum(["ok", "no", "skip"]);
+/** A card's id, as the page and this module give them. */
+const cardId = z.string().regex(/^[a-z][a-z0-9-]{0,63}$/);
+/** Where a person is in a run's review, as the page sends it: kept with the run. */
+export const reviewAnswers = z.strictObject({
+    answers: z.record(cardId, answer),
+    notes: z.record(cardId, z.string().max(4000)),
+    seen: z.array(cardId).max(500),
+    position: z.number().int().min(0).max(500),
+    startedAt: z.number().int().min(0).nullable(),
+    endedAt: z.number().int().min(0).nullable(),
+});
+//# sourceMappingURL=review-page.js.map

package/dist/domain/review-page.js.map

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

package/dist/domain/spec-page.d.ts

@@ -0,0 +1,132 @@
+import { z } from "@clemrig/flow";
+import type { Parsed } from "./parsed.js";
+import { type Spec } from "./spec.js";
+/** Above this size, a mockup is refused: a sketch of an interface fits well below it. */
+export declare const maxMockupBytes: number;
+/**
+ * How the agent that wrote a spec with the operator presents it, for the
+ * operator to validate it on the spec page: in plain words, in the spec's
+ * language, each change with a mockup when it brings an interface.
+ */
+export declare const specPresentation: z.ZodObject<{
+    need: z.ZodString;
+    changes: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        text: z.ZodString;
+        mockup: z.ZodOptional<z.ZodObject<{
+            caption: z.ZodString;
+            html: z.ZodString;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    decisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        why: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+        chosen: z.ZodString;
+    }, z.core.$strict>>;
+    criteria: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        criteria: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            plain: z.ZodString;
+            check: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    outOfScope: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type SpecPresentation = z.output<typeof specPresentation>;
+/** What the factory keeps of a presented spec: the presentation, and the spec it presents, word for word. */
+export declare const presentedSpec: z.ZodObject<{
+    spec: z.ZodString;
+    presentation: z.ZodObject<{
+        need: z.ZodString;
+        changes: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            text: z.ZodString;
+            mockup: z.ZodOptional<z.ZodObject<{
+                caption: z.ZodString;
+                html: z.ZodString;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        decisions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            why: z.ZodString;
+            options: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>>;
+            chosen: z.ZodString;
+        }, z.core.$strict>>;
+        criteria: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            criteria: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                plain: z.ZodString;
+                check: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        outOfScope: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type PresentedSpec = z.output<typeof presentedSpec>;
+/** What is wrong with a presentation of `spec`: criteria not presented once each, choices whose options do not hold. */
+export declare function presentationProblems(presentation: SpecPresentation, spec: Spec): string[];
+/** A presentation an agent drafted, checked against the spec it presents. */
+export declare function parsePresentation(draft: string, spec: Spec): Parsed<SpecPresentation>;
+/** What the spec page shows of a presented spec; `@clemrig/factory-ui` draws it. */
+export interface SpecPage {
+    issue: string;
+    title: string;
+    stale: boolean;
+    need: string;
+    changes: SpecPresentation["changes"];
+    decisions: SpecPresentation["decisions"];
+    criteria: {
+        title: string;
+        criteria: {
+            id: string;
+            text: string;
+            plain: string;
+            check: string;
+        }[];
+    }[];
+    outOfScope: string[];
+    spec: {
+        objective: string;
+        scope: string;
+        outOfScope: string;
+        constraints: string;
+    };
+}
+/**
+ * The page of issue `slug`'s presented spec, in the words of the spec it
+ * presents; stale when `current`, the spec now, says something else.
+ * `undefined` when the spec it presents no longer reads.
+ */
+export declare function specPage(slug: string, { spec: text, presentation }: PresentedSpec, current: string | undefined): SpecPage | undefined;
+/** Where a person is in a spec's validation, as the page sends it: the review's answers, and the options taken. */
+export declare const specAnswers: z.ZodObject<{
+    answers: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        no: "no";
+        ok: "ok";
+        skip: "skip";
+    }>>;
+    notes: z.ZodRecord<z.ZodString, z.ZodString>;
+    seen: z.ZodArray<z.ZodString>;
+    position: z.ZodNumber;
+    startedAt: z.ZodNullable<z.ZodNumber>;
+    endedAt: z.ZodNullable<z.ZodNumber>;
+    choices: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export type SpecAnswers = z.output<typeof specAnswers>;

package/dist/domain/spec-page.js

@@ -0,0 +1,155 @@
+import { z } from "@clemrig/flow";
+import { reviewAnswers } from "./review-page.js";
+import { parseSpec } from "./spec.js";
+/** An id a card is kept under: a choice's, an option's. */
+const id = z
+    .string()
+    .regex(/^[a-z][a-z0-9-]{0,39}$/, "Expected a lowercase letter, then lowercase letters, digits or hyphens: 40 characters at most");
+const text = (max) => z.string().trim().min(1).max(max);
+/** Above this size, a mockup is refused: a sketch of an interface fits well below it. */
+export const maxMockupBytes = 256 * 1024;
+const mockup = z.strictObject({
+    caption: text(300),
+    html: z
+        .string()
+        .min(1)
+        .refine((html) => new TextEncoder().encode(html).length <= maxMockupBytes, `At most ${maxMockupBytes / 1024} KiB`),
+    width: z.number().int().min(320).max(1600),
+    height: z.number().int().min(200).max(4000),
+});
+/**
+ * How the agent that wrote a spec with the operator presents it, for the
+ * operator to validate it on the spec page: in plain words, in the spec's
+ * language, each change with a mockup when it brings an interface.
+ */
+export const specPresentation = z.strictObject({
+    need: text(4000),
+    changes: z
+        .array(z.strictObject({
+        title: text(200),
+        text: text(4000),
+        mockup: mockup.optional(),
+    }))
+        .min(1)
+        .max(20),
+    decisions: z
+        .array(z.strictObject({
+        id,
+        title: text(300),
+        why: text(2000),
+        options: z
+            .array(z.strictObject({ id, title: text(200), text: text(2000) }))
+            .min(2)
+            .max(5),
+        chosen: id,
+    }))
+        .max(20),
+    criteria: z
+        .array(z.strictObject({
+        title: text(200),
+        criteria: z
+            .array(z.strictObject({
+            id: z.string().regex(/^AC[1-9]\d*$/, "Expected AC<n>"),
+            plain: text(1000),
+            check: text(500),
+        }))
+            .min(1),
+    }))
+        .min(1)
+        .max(20),
+    outOfScope: z.array(text(500)).max(30),
+});
+/** What the factory keeps of a presented spec: the presentation, and the spec it presents, word for word. */
+export const presentedSpec = z.strictObject({
+    spec: z.string(),
+    presentation: specPresentation,
+});
+/** What is wrong with a presentation of `spec`: criteria not presented once each, choices whose options do not hold. */
+export function presentationProblems(presentation, spec) {
+    const problems = [];
+    const presented = presentation.criteria.flatMap(({ criteria }) => criteria.map(({ id }) => id));
+    const known = new Set(spec.criteria.map(({ id }) => id));
+    for (const criterion of spec.criteria)
+        if (!presented.includes(criterion.id))
+            problems.push(`criteria: ${criterion.id} is not presented`);
+    for (const criterion of new Set(presented)) {
+        if (!known.has(criterion))
+            problems.push(`criteria: ${criterion} is not a criterion of the spec`);
+        if (presented.indexOf(criterion) !== presented.lastIndexOf(criterion))
+            problems.push(`criteria: ${criterion} is presented more than once`);
+    }
+    const decisions = presentation.decisions.map(({ id }) => id);
+    presentation.decisions.forEach((decision, index) => {
+        const where = `decisions[${index}]`;
+        if (decisions.indexOf(decision.id) !== index)
+            problems.push(`${where}: ${decision.id} is the id of another choice`);
+        const options = decision.options.map(({ id }) => id);
+        for (const option of new Set(options))
+            if (options.indexOf(option) !== options.lastIndexOf(option))
+                problems.push(`${where}: option ${option} is listed twice`);
+        if (!options.includes(decision.chosen))
+            problems.push(`${where}.chosen: ${decision.chosen} is not an option`);
+    });
+    return problems;
+}
+/** A presentation an agent drafted, checked against the spec it presents. */
+export function parsePresentation(draft, spec) {
+    let value;
+    try {
+        value = JSON.parse(draft);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            problems: [`Not JSON: ${error instanceof Error ? error.message : error}`],
+        };
+    }
+    const parsed = specPresentation.safeParse(value);
+    if (!parsed.success)
+        return { ok: false, problems: [z.prettifyError(parsed.error)] };
+    const problems = presentationProblems(parsed.data, spec);
+    return problems.length > 0
+        ? { ok: false, problems }
+        : { ok: true, value: parsed.data };
+}
+/**
+ * The page of issue `slug`'s presented spec, in the words of the spec it
+ * presents; stale when `current`, the spec now, says something else.
+ * `undefined` when the spec it presents no longer reads.
+ */
+export function specPage(slug, { spec: text, presentation }, current) {
+    const parsed = parseSpec(text, slug);
+    if (!parsed.ok)
+        return undefined;
+    const spec = parsed.value;
+    const words = new Map(spec.criteria.map(({ id, text }) => [id, text]));
+    return {
+        issue: slug,
+        title: spec.title,
+        stale: current !== text,
+        need: presentation.need,
+        changes: presentation.changes,
+        decisions: presentation.decisions,
+        criteria: presentation.criteria.map((group) => ({
+            title: group.title,
+            criteria: group.criteria.map((criterion) => ({
+                id: criterion.id,
+                text: words.get(criterion.id) ?? "",
+                plain: criterion.plain,
+                check: criterion.check,
+            })),
+        })),
+        outOfScope: presentation.outOfScope,
+        spec: {
+            objective: spec.objective,
+            scope: spec.scope,
+            outOfScope: spec.outOfScope,
+            constraints: spec.constraints,
+        },
+    };
+}
+/** Where a person is in a spec's validation, as the page sends it: the review's answers, and the options taken. */
+export const specAnswers = reviewAnswers.extend({
+    choices: z.record(id, id),
+});
+//# sourceMappingURL=spec-page.js.map

package/dist/domain/spec-page.js.map

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

package/dist/system/environment.d.ts

@@ -1,2 +1,8 @@
 /** Optional `.factory/.env` secrets; existing shell variables retain precedence. */
 export declare function loadLocalEnvironment(factoryDir: string): void;
+/**
+ * Where others reach `factory ui`, such as the address `tailscale serve`
+ * gives it: `FACTORY_UI_URL`, from the shell or `.factory/.env`, always
+ * ending with `/`; `undefined` when unset.
+ */
+export declare function uiUrl(): URL | undefined;

package/dist/system/environment.js

@@ -10,4 +10,23 @@ export function loadLocalEnvironment(factoryDir) {
             throw new Error(`Cannot load .env from ${factoryDir}`);
     }
 }
+/**
+ * Where others reach `factory ui`, such as the address `tailscale serve`
+ * gives it: `FACTORY_UI_URL`, from the shell or `.factory/.env`, always
+ * ending with `/`; `undefined` when unset.
+ */
+export function uiUrl() {
+    const value = process.env.FACTORY_UI_URL?.trim();
+    if (!value)
+        return undefined;
+    const url = URL.parse(value);
+    if (!url ||
+        !["http:", "https:"].includes(url.protocol) ||
+        url.search ||
+        url.hash)
+        throw new Error(`FACTORY_UI_URL must be the http or https address of factory ui, such as https://forge.example.ts.net/; it is ${value}`);
+    if (!url.pathname.endsWith("/"))
+        url.pathname += "/";
+    return url;
+}
 //# sourceMappingURL=environment.js.map

package/dist/system/environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/system/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/system/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,IAAI,CAAC;QACH,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YACpD,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK;IACnB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,IACE,CAAC,GAAG;QACJ,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC3C,GAAG,CAAC,MAAM;QACV,GAAG,CAAC,IAAI;QAER,MAAM,IAAI,KAAK,CACb,gHAAgH,KAAK,EAAE,CACxH,CAAC;IACJ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC;IACrD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/system/factory.d.ts

@@ -11,6 +11,8 @@ export interface Factory {
 }
 /** A factory without workflows, to read runs when `factory.ts` cannot load. */
 export declare function emptyFactory(factoryDir: string): Factory;
+/** A run's directory, where it keeps its files. */
+export declare function runDir(factory: Factory, id: string): string;
 /** 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;

package/dist/system/factory.js

@@ -12,6 +12,10 @@ export function emptyFactory(factoryDir) {
         packaged: new Set(),
     };
 }
+/** A run's directory, where it keeps its files. */
+export function runDir(factory, id) {
+    return join(factory.runsDir, id);
+}
 /** 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));

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

@@ -35,7 +35,11 @@ export declare function recentCommits(dir: string, since: {
 } | {
     days: number;
 }, max: number): Promise<RecentCommit[]>;
-/** The diff from one commit or tree to another. */
+/**
+ * The diff from one commit or tree to another, as its readers take it
+ * whatever Git's configuration says: names after `a/` and `b/`, unescaped
+ * letters, no colors, each line as the files have it.
+ */
 export declare function diff(dir: string, before: string, after: string): Promise<{
     text: string;
     truncated: boolean;

package/dist/system/git.js

@@ -134,9 +134,26 @@ export async function recentCommits(dir, since, max) {
     }
     return commits;
 }
-/** The diff from one commit or tree to another. */
+/**
+ * The diff from one commit or tree to another, as its readers take it
+ * whatever Git's configuration says: names after `a/` and `b/`, unescaped
+ * letters, no colors, each line as the files have it.
+ */
 export async function diff(dir, before, after) {
-    const result = await git(dir, ["diff", before, after]);
+    const result = await git(dir, [
+        "-c",
+        "core.quotePath=false",
+        "-c",
+        "diff.suppressBlankEmpty=false",
+        "diff",
+        "--no-ext-diff",
+        "--no-textconv",
+        "--no-color",
+        "--src-prefix=a/",
+        "--dst-prefix=b/",
+        before,
+        after,
+    ]);
     return { text: result.stdout, truncated: result.stdoutTruncated };
 }
 /** Each file that differs from one commit or tree to another, with its added and removed lines, renames seen as `diff` sees them. */