@clemrig/factory 0.18.3 → 0.20.0

package/dist/domain/description.js

@@ -1,14 +1,39 @@
 import { z } from "@clemrig/flow";
+import { diffExcerpt } from "./diff.js";
 const text = z.string().trim().min(1);
-/** What GitHub draws: a mermaid diagram; a diff or a text block shows a shape as it is. */
+const line = z.number().int().min(1);
+/** What the review page draws: a mermaid diagram; a diff or a text block shows a shape as it is. */
 export const visualKinds = ["mermaid", "diff", "text"];
-/** The image files a pull request shows, as GitHub accepts them. */
+/** The image files the review page shows. */
 const imageExtensions = [".png", ".jpg", ".jpeg", ".gif", ".webp"];
-/** GitHub's limit for an image attached to a pull request. */
+/** The largest screenshot: the review page loads it whole, on a phone too. */
 export const maxScreenshotBytes = 10 * 1024 * 1024;
+/** What a decision departs from: the spec's scope, a test that existed, or the spec's letter. */
+export const decisionKinds = [
+    "beyond_spec",
+    "changed_test",
+    "spec_reading",
+];
+/** What a decision's card shows: one of these, with its own fields. */
+export const decisionVisualKinds = [
+    "reading",
+    "diff",
+    "screenshots",
+    "list",
+];
+/** The fields each kind of visual takes. */
+const visualFields = {
+    reading: { spec: true, read: true },
+    diff: { file: true, from: true, to: true },
+    screenshots: { files: true },
+    list: { items: true },
+};
+/** The longest excerpt of the diff a card shows, in lines of the file. */
+const maxExcerptLines = 60;
 /**
  * The describing agent's response: what a reader who forgot the issue needs
- * to review its pull request. As many items as the change calls for.
+ * to review its pull request, on the review page. As many items as the
+ * change calls for.
  */
 export const descriptionOutput = z.strictObject({
     /** Each change of behavior, as a user, a client or an operator observes it. */
@@ -41,12 +66,110 @@ export const descriptionOutput = z.strictObject({
     screenshots: z.array(z.strictObject({ file: text, caption: text })),
     /** Why there is no screenshot, when there is none. */
     noScreenshots: text.optional(),
+    /**
+     * What a person decides before merging, one card each: every change beyond
+     * the spec, every existing test whose expectation changed, every reading of
+     * the spec beyond its letter.
+     */
+    decisions: z.array(z.strictObject({
+        kind: z.enum(decisionKinds),
+        /** The decision, in a sentence. */
+        title: text,
+        /** The criterion it bears on. */
+        criterion: text.optional(),
+        /** The answer advised. */
+        advice: z.enum(["accept", "revise"]),
+        /** Why that answer, in a sentence or two. */
+        recommendation: text,
+        /** Why it needs a person. */
+        why: text,
+        /** The interpretation (`I1`…) or deviation (`D1`…) it comes from. */
+        source: z
+            .string()
+            .regex(/^[ID][1-9]\d*$/)
+            .optional(),
+        /** The changed file to open. */
+        file: text.optional(),
+        /** What its card shows; the fields of its kind only. */
+        visual: z
+            .strictObject({
+            kind: z.enum(decisionVisualKinds),
+            /** `reading`: the spec's words, and the plan's reading of them. */
+            spec: text.optional(),
+            read: text.optional(),
+            /** `diff`: a changed file and lines of its new version (of its old one, for a deleted file). */
+            file: text.optional(),
+            from: line.optional(),
+            to: line.optional(),
+            /** `screenshots`: screenshots of the description, by file. */
+            files: z.array(text).min(1).optional(),
+            /** `list`: a few short items. */
+            items: z.array(text).min(1).optional(),
+        })
+            .optional(),
+    })),
+    /** What only a person can check, which the run could not: on a real device, with real data. */
+    manualChecks: z.array(z.strictObject({
+        /** What to do, in a sentence. */
+        title: text,
+        /** What should happen. */
+        expect: text,
+        /** Why the run could not check it. */
+        why: text,
+    })),
 });
-/** What `gh` attaches in one command. */
-const maxScreenshots = 50;
-/** What is wrong with a description of these changed files, the screenshots' files aside. */
-export function descriptionProblems(description, files) {
-    const changed = new Set(files.map(({ path }) => path));
+/** What is wrong with a decision's visual. */
+function visualProblems(visual, where, { diff }, shots) {
+    const fields = Object.keys(visualFields[visual.kind]);
+    const given = Object.entries(visual).flatMap(([key, value]) => key !== "kind" && value !== undefined ? [key] : []);
+    const problems = [
+        ...fields
+            .filter((field) => !given.includes(field))
+            .map((field) => `${where}: ${visual.kind} needs ${field}`),
+        ...given
+            .filter((field) => !fields.includes(field))
+            .map((field) => `${where}: ${visual.kind} takes no ${field}`),
+    ];
+    if (problems.length > 0)
+        return problems;
+    const { file, from, to, files = [] } = visual;
+    if (file !== undefined && from !== undefined && to !== undefined) {
+        if (to < from || to - from >= maxExcerptLines)
+            problems.push(`${where}: from ${from} to ${to}, give at most ${maxExcerptLines} lines, in order`);
+        else if (!diffExcerpt(diff, file, from, to))
+            problems.push(`${where}: the diff changes no line of ${file} from ${from} to ${to}`);
+    }
+    for (const shot of files)
+        if (!shots.includes(shot))
+            problems.push(`${where}: ${shot} is not one of the screenshots`);
+    return problems;
+}
+/** What is wrong with the decisions: their sources, criteria, files and visuals. */
+function decisionProblems({ decisions, screenshots }, described, changed) {
+    const shots = screenshots.map(({ file }) => file);
+    const ids = described.criteria.map(({ id }) => id);
+    return decisions.flatMap((decision, index) => {
+        const where = `decisions[${index}]`;
+        const problems = [];
+        if (decision.criterion !== undefined && !ids.includes(decision.criterion))
+            problems.push(`${where}: ${decision.criterion} is not a criterion`);
+        if (decision.source !== undefined) {
+            const count = decision.source[0] === "I"
+                ? described.interpretations
+                : described.deviations;
+            if (Number(decision.source.slice(1)) > count)
+                problems.push(`${where}: there is no ${decision.source}`);
+        }
+        if (decision.file !== undefined && !changed.has(decision.file))
+            problems.push(`${where}: ${decision.file} is not a changed file`);
+        if (decision.visual)
+            problems.push(...visualProblems(decision.visual, `${where}.visual`, described, shots));
+        return problems;
+    });
+}
+/** What is wrong with a description of this change, the screenshots' files aside. */
+export function descriptionProblems(description, described) {
+    const changed = new Set(described.files.map(({ path }) => path));
     const problems = [];
     const { start, groups } = description.guide;
     if (!changed.has(start.file))
@@ -67,12 +190,10 @@ export function descriptionProblems(description, files) {
         if (shots.indexOf(file) !== shots.lastIndexOf(file))
             problems.push(`screenshots: ${file} is listed twice`);
     }
-    if (shots.length > maxScreenshots)
-        problems.push(`screenshots: ${maxScreenshots} at most`);
     if (shots.length === 0 && !description.noScreenshots)
         problems.push("noScreenshots: say why there is no screenshot");
     if (shots.length > 0 && description.noScreenshots)
         problems.push("noScreenshots: give it only when there is no screenshot");
-    return problems;
+    return [...problems, ...decisionProblems(description, described, changed)];
 }
 //# sourceMappingURL=description.js.map

package/dist/domain/description.js.map

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

package/dist/domain/diff.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The excerpt of `path`'s diff that shows lines `from` to `to` of its new
+ * version (of its old one, for a deleted file), with the lines removed just
+ * before each of them; each line keeps its mark, the common indentation
+ * removed, and `…` separates two hunks. `undefined` when it changes none of
+ * these lines.
+ */
+export declare function diffExcerpt(diff: string, path: string, from: number, to: number): string | undefined;

package/dist/domain/diff.js

@@ -0,0 +1,90 @@
+const escapes = {
+    a: "\x07",
+    b: "\b",
+    t: "\t",
+    n: "\n",
+    v: "\v",
+    f: "\f",
+    r: "\r",
+};
+/**
+ * A name of a `---` or `+++` line, as Git writes it: followed by a tab when
+ * it has a space, quoted C style when it has special characters, its bytes
+ * outside ASCII in octal.
+ */
+function nameOf(written) {
+    const name = written.replace(/\t$/, "");
+    if (!name.startsWith('"'))
+        return name;
+    const bytes = [];
+    for (const [, octal, escaped, plain] of name
+        .slice(1, -1)
+        .matchAll(/\\([0-7]{3})|\\(.)|([^\\]+)/gs)) {
+        if (octal)
+            bytes.push(Number.parseInt(octal, 8));
+        else
+            bytes.push(...new TextEncoder().encode(escaped === undefined ? plain : (escapes[escaped] ?? escaped)));
+    }
+    return new TextDecoder().decode(new Uint8Array(bytes));
+}
+/**
+ * The lines of `path`'s hunks in a unified diff of several files, its names
+ * after `a/` and `b/`; `undefined` when the diff does not change it.
+ */
+function linesOf(diff, path) {
+    for (const section of diff.split(/^(?=diff --git )/m)) {
+        const lines = section.split("\n");
+        const start = lines.findIndex((line) => line.startsWith("@@ "));
+        const head = start === -1 ? lines : lines.slice(0, start);
+        const named = (marker) => {
+            const line = head.find((each) => each.startsWith(marker));
+            return line === undefined ? undefined : nameOf(line.slice(4));
+        };
+        const deleted = named("+++ ") === "/dev/null";
+        if (deleted ? named("--- ") !== `a/${path}` : named("+++ ") !== `b/${path}`)
+            continue;
+        const numbered = [];
+        let hunk = -1;
+        let next = 0;
+        for (const line of start === -1 ? [] : lines.slice(start)) {
+            const range = /^@@ -(\d+)(?:,\d+)? \+(\d+)(?:,\d+)? @@/.exec(line);
+            if (range) {
+                hunk += 1;
+                next = Number(deleted ? range[1] : range[2]);
+                continue;
+            }
+            const mark = line[0];
+            // `` is no line of the file.
+            if (mark !== "+" && mark !== "-" && mark !== " ")
+                continue;
+            numbered.push({ mark, text: line.slice(1), hunk, number: next });
+            if (deleted ? mark !== "+" : mark !== "-")
+                next += 1;
+        }
+        return numbered;
+    }
+    return undefined;
+}
+/**
+ * The excerpt of `path`'s diff that shows lines `from` to `to` of its new
+ * version (of its old one, for a deleted file), with the lines removed just
+ * before each of them; each line keeps its mark, the common indentation
+ * removed, and `…` separates two hunks. `undefined` when it changes none of
+ * these lines.
+ */
+export function diffExcerpt(diff, path, from, to) {
+    const kept = (linesOf(diff, path) ?? []).filter(({ number }) => number >= from && number <= to);
+    if (!kept.some(({ mark }) => mark !== " "))
+        return undefined;
+    const indents = kept
+        .filter(({ text }) => text.trim() !== "")
+        .map(({ text }) => /^[ \t]*/.exec(text)?.[0].length ?? 0);
+    const indent = indents.length > 0 ? Math.min(...indents) : 0;
+    return kept
+        .flatMap(({ mark, text, hunk }, index) => [
+        ...(index > 0 && kept[index - 1]?.hunk !== hunk ? [" …"] : []),
+        `${mark}${text.slice(indent).replaceAll("\t", "  ")}`,
+    ])
+        .join("\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/domain/diff.js.map

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

package/dist/domain/pull-request.d.ts

@@ -1,23 +1,11 @@
 import type { Description } from "./description.js";
 import { type ChangedFile, type Review } from "./review.js";
 import type { Criterion } from "./spec.js";
-import { type CheckResult } from "./verification.js";
-/** The first `gh` that attaches images to a pull request (`--attach`). */
-export declare const minimumGhVersion = "2.99.0";
-/** Why this `gh` cannot open the pull request, if it cannot. */
-export declare function ghVersionProblem(version: string): string | undefined;
-/** Below GitHub's limit for a pull request's body (65,536 characters), with room for the screenshots' links. */
-export declare const maxBodyLength = 60000;
+import type { CheckResult } from "./verification.js";
 export interface PullRequestFacts {
-    /** The spec's Objective: why the change exists. */
-    objective: string;
     criteria: Criterion[];
     /** Where the implementation departs from the plan, and why. */
     deviations: string[];
-    /** The plan's reading of the spec where it reads more than one way: to confirm before merging. */
-    interpretations: string[];
-    /** What the plan assumed: its risks. */
-    assumptions: string[];
     review: Review;
     /**
      * Whether the operator delivered the change as the review left it: its
@@ -37,21 +25,21 @@ export interface PullRequestFacts {
     /** The change's files, since the plan's commit. */
     files: ChangedFile[];
     description: Description;
-    /**
-     * Whether the screenshots are still to attach. Once attached, the body names
-     * each by its file, which gh replaces with its upload's link.
-     */
-    screenshotsPending: boolean;
     /** Where a reader opens the spec and the plan, at the commits the run read and wrote them. */
     links: {
         spec: string;
         plan: string;
     };
     runId: string;
+    /** The review page's address, when `factory ui` has one others can reach. */
+    reviewPage?: string;
 }
-/** Everything needed to review the change without remembering its issue or opening the run. */
+/** The review page's address, relative to where `factory ui` serves. */
+export declare function reviewPath(runId: string): string;
+/**
+ * The pull request's body: what it risks and proves at a glance, and the
+ * link to its review page, which shows everything else from the run.
+ */
 export declare function pullRequestBody(facts: PullRequestFacts): string;
-/** How many readings of the spec the plan chose, as the terminal shows them once the pull request is open. */
-export declare function interpretationsLine(count: number): string;
 /** The danger of merging, as the terminal shows it once the pull request is open. */
 export declare function mergeDangerLine({ danger }: Description): string;