toolroll 0.8.2 → 0.9.1

package/dist/pull-request-schema.js

@@ -0,0 +1,21 @@
+/** A pull request opened by "Complete and open a pull request" is followed until it merges: how many CI
+ * revisions it has filed (counted across the revisions of one task, at most two), the failing head each
+ * answered, when a person was asked instead, the green head announced as ready, and the merge itself. One row
+ * per publication; the publication row stays the record of the push and the PR. */
+export const PULL_REQUEST_SCHEMA = `
+CREATE TABLE IF NOT EXISTS pull_request_follow (
+  publication   INTEGER PRIMARY KEY REFERENCES publication(id) ON DELETE CASCADE,
+  revisions     INTEGER NOT NULL DEFAULT 0 CHECK (revisions >= 0),
+  red_head      TEXT,
+  revision_task TEXT,
+  asked_head    TEXT,
+  ready_head    TEXT,
+  merge_commit  TEXT,
+  merge_method  TEXT CHECK (merge_method IS NULL OR merge_method IN ('squash','merge','rebase')),
+  merged_by     TEXT,
+  merged_at     TEXT,
+  merge_error   TEXT,
+  created_at    TEXT NOT NULL,
+  updated_at    TEXT NOT NULL
+);
+`;

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

@@ -0,0 +1,23 @@
+/** Settings → Projects → Pull requests: one project's pull-request setup, in plain words. Off shows what setup
+ * found (or what to fix) and one Turn on; on shows where pull requests go and how they merge. Every change takes
+ * the password; turning on restates the exact repository and branch that were checked. */
+import type { Publishing, PublishingPlan } from "./pull-request-flow.js";
+export type PullRequestSettingsView = {
+    repo: string;
+    name: string;
+    csrf: string;
+    canChange: boolean;
+    publishing: Publishing;
+    /** When off: what setup found — the plan to confirm, or what to fix first. */
+    check: {
+        ok: true;
+        plan: PublishingPlan;
+    } | {
+        ok: false;
+        message: string;
+    } | null;
+    said: string | null;
+    problem: string | null;
+};
+export declare function pullRequestSettingsHtml(view: PullRequestSettingsView): string;
+export declare const PULL_REQUEST_SETTINGS_CSS = "\n  .pr-settings { display: grid; gap: .6rem; max-width: 40rem; }\n  .pr-settings p, .pr-settings h2 { margin: 0; }\n  .pr-settings label { display: grid; gap: .25rem; }\n  .pr-settings label input[type=password], .pr-settings select { min-height: 44px; box-sizing: border-box; width: 100%; }\n  .pr-settings .pr-check { display: flex; align-items: center; gap: .5rem; min-height: 44px; }\n  .pr-settings button { min-height: 44px; justify-self: start; }\n  .pr-terms { margin: 0; padding-left: 1.1rem; display: grid; gap: .25rem; }\n  @media (max-width: 480px) { .pr-settings button { justify-self: stretch; } }\n";

package/dist/pull-request-ui.js

@@ -0,0 +1,55 @@
+const escape = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+const METHOD_WORDS = { squash: "Squash and merge", merge: "Merge commit", rebase: "Rebase and merge" };
+export function pullRequestSettingsHtml(view) {
+    const hidden = (act) => `<input type="hidden" name="csrf" value="${escape(view.csrf)}"><input type="hidden" name="repo" value="${escape(view.repo)}"><input type="hidden" name="act" value="${act}">`;
+    const password = `<label>Password<input type="password" name="password" autocomplete="current-password" required></label>`;
+    const notes = [
+        view.said === null ? "" : `<p class="notice" role="status">${escape(view.said)}</p>`,
+        view.problem === null ? "" : `<p class="problem" role="alert">${escape(view.problem)}</p>`,
+    ].join("");
+    const head = `<p class="meta">${escape(view.name)} · <span class="mono">${escape(view.repo)}</span></p>${notes}`;
+    const publishing = view.publishing;
+    if (publishing.on) {
+        const status = `<section class="card pr-settings"><p><strong>On</strong> · <span class="mono">${escape(publishing.githubRepo)}</span> into <span class="mono">${escape(publishing.base)}</span></p>` +
+            `<p class="meta">${publishing.legacy ? "Every finished build opens a pull request (set up with publish grant)." : "Complete offers “Complete and open a pull request”."} Set up by ${escape(publishing.grantedBy)}.</p></section>`;
+        if (!view.canChange)
+            return head + status;
+        const methods = ["squash", "merge", "rebase"].map(method => `<option value="${method}"${publishing.mergeMethod === method ? " selected" : ""}>${METHOD_WORDS[method]}${method === "squash" ? " (default)" : ""}</option>`).join("");
+        return head + status +
+            `<form method="post" action="/settings/pull-requests" class="card pr-settings">${hidden("settings")}` +
+            `<h2>Merging</h2>` +
+            `<label>Merge method<select name="method">${methods}</select></label>` +
+            `<label class="row pr-check"><input type="checkbox" name="when-green" value="1"${publishing.mergeWhenGreen ? " checked" : ""}> Merge when checks pass</label>` +
+            `<p class="meta">Off by default. When on, a pull request merges by itself once its checks pass on the completed commit. Branches are deleted after merging.</p>` +
+            `${password}<button type="submit">Save</button></form>` +
+            `<details class="settings-more"><summary>Turn off pull requests</summary>` +
+            `<form method="post" action="/settings/pull-requests" class="card pr-settings">${hidden("off")}` +
+            `<p class="meta">Nothing more is pushed. Open pull requests stay on GitHub.</p>${password}<button type="submit" class="danger">Turn off</button></form></details>`;
+    }
+    const check = view.check;
+    if (check === null)
+        return head + `<section class="card pr-settings"><p><strong>Off</strong></p><p class="meta">An approver can turn on pull requests.</p></section>`;
+    if (!check.ok) {
+        return head + `<section class="card pr-settings"><p><strong>Can’t turn on yet</strong></p><p>${escape(check.message)}</p>` +
+            `<p><a class="button-link" href="/settings/pull-requests?repo=${encodeURIComponent(view.repo)}">Check again</a></p></section>`;
+    }
+    const plan = check.plan;
+    return head +
+        `<form method="post" action="/settings/pull-requests" class="card pr-settings">${hidden("on")}` +
+        `<input type="hidden" name="github" value="${escape(plan.githubRepo)}"><input type="hidden" name="base" value="${escape(plan.base)}">` +
+        `<p><strong>Ready to turn on</strong></p>` +
+        `<ul class="pr-terms"><li>Pull requests open on <span class="mono">${escape(plan.githubRepo)}</span> into <span class="mono">${escape(plan.base)}</span>${plan.account === null ? "" : `, as ${escape(plan.account)}`}.</li>` +
+        `<li>Complete offers “Complete and open a pull request”, from the exact completed commit. A flow's Pull request zone can open one too.</li>` +
+        `<li>Merging squashes and deletes the branch. A person merges with their password; a flow merges only when its zone says so, after a person approved the card.</li></ul>` +
+        `${password}<button type="submit">Turn on pull requests</button></form>`;
+}
+export const PULL_REQUEST_SETTINGS_CSS = `
+  .pr-settings { display: grid; gap: .6rem; max-width: 40rem; }
+  .pr-settings p, .pr-settings h2 { margin: 0; }
+  .pr-settings label { display: grid; gap: .25rem; }
+  .pr-settings label input[type=password], .pr-settings select { min-height: 44px; box-sizing: border-box; width: 100%; }
+  .pr-settings .pr-check { display: flex; align-items: center; gap: .5rem; min-height: 44px; }
+  .pr-settings button { min-height: 44px; justify-self: start; }
+  .pr-terms { margin: 0; padding-left: 1.1rem; display: grid; gap: .25rem; }
+  @media (max-width: 480px) { .pr-settings button { justify-self: stretch; } }
+`;

package/dist/pulls.d.ts

@@ -92,6 +92,11 @@ export declare function parsePulls(json: string): Pull[] | null;
  * guard excluded it did exactly what it was written to do.
  */
 export declare function summarizeChecks(rollup: unknown): ChecksState;
+/** The checks that finished and did not succeed, by the name GitHub shows, with their details page when one is given. */
+export declare function failingChecks(rollup: unknown): {
+    name: string;
+    url: string | null;
+}[];
 /**
  * Whose move it is.
  *

package/dist/pulls.js

@@ -155,6 +155,17 @@ export function summarizeChecks(rollup) {
         return "running";
     return "passing";
 }
+/** The checks that finished and did not succeed, by the name GitHub shows, with their details page when one is given. */
+export function failingChecks(rollup) {
+    if (!Array.isArray(rollup))
+        return [];
+    return rollup.filter(entry => readCheckState(entry) === "failing").map(entry => {
+        const raw = entry;
+        const name = readString(raw["name"]) || readString(raw["context"]) || "a check";
+        const url = readString(raw["detailsUrl"]) || readString(raw["targetUrl"]);
+        return { name, url: url === "" ? null : url };
+    });
+}
 function readCheckState(entry) {
     if (typeof entry !== "object" || entry === null)
         return "none";

package/dist/serve.d.ts

@@ -2,6 +2,7 @@ import { CodingWorkspace } from './coding-workspace.js';
 import { type MailSender } from "./flow-actions.js";
 import { type TriggerIo } from "./flow-triggers.js";
 import { type AssignmentSnapshot } from './assignment.js';
+import type { PublishExec } from './publish.js';
 import { type VersionRunner } from "./model-catalog.js";
 import { type Server } from "node:http";
 import { type ProofVerdict, type CriterionMatrixRow } from "./proof.js";
@@ -11,6 +12,7 @@ import { run as execRun } from "./exec.js";
 import { type AgentChoice } from "./agentconfig.js";
 import { type RouteProjection, type RouteOverride, type RouteStamp, type RiskLevel } from "./phase-routing.js";
 import { type Phase } from "./provider.js";
+import { type IntegrationIo } from "./integrations.js";
 import { launchRuntimeUpdate } from "./toolroll-update.js";
 import type { RevisionLineage } from "./store.js";
 import type { SubscriptionMateRunner } from "./subscription-chat.js";
@@ -123,6 +125,8 @@ export type ServeOptions = {
     connectionHome?: string;
     /** Test seam for Chat's first tasks: the `gh` and `git grep` reads. */
     firstTaskRunner?: typeof execRun;
+    /** Test seam for Settings → Integrations: how its checks reach services (fetch, gh, mail servers). */
+    integrationIo?: Partial<IntegrationIo>;
     modelCatalogFetcher?: typeof fetch;
     /** Test seams for Settings → Models: CLI version probes and the PATH they search. */
     modelRunner?: VersionRunner;
@@ -155,6 +159,8 @@ export type ServeOptions = {
     ghPreview?: typeof previewGithubRepo;
     ghClone?: typeof cloneGithubRepo;
     ghList?: typeof listGithubRepos;
+    /** Injected by tests: the git and gh calls pull-request setup and Merge make. */
+    publishExec?: PublishExec;
 };
 export declare function createDecisionServer(options: ServeOptions): Server;
 /**