toolroll 0.8.2 → 0.9.1

package/CHANGELOG.md

@@ -2,6 +2,55 @@
 
 ## Unreleased
 
+## 0.9.1 — 2026-09-30
+
+- **Phones show more on a screen.** On a phone the console is about a third
+  denser: a row's action sits on its title line, status chips beside the
+  name, facts on one line, and times shorten to "16:39", "Yesterday 16:39"
+  or "Sep 28" (the full time stays on desktop and on hover). Every tap target
+  is still at least 44px and text fields 16px; nothing scrolls sideways at
+  320px, and the desktop layout is unchanged.
+- **Flows open pull requests, and starter flows are one yes away.** A new
+  Pull request zone opens a PR for a card's built result under the project's
+  pull request setup, waits for CI, moves on when it passes and takes the
+  failure path (naming the failing check) when it fails; it can merge, squash
+  by default, only after a person approved the card. The Issues to PRs
+  template runs labelled GitHub issues through build, approval, pull request
+  and a closing comment. Settings → Flows and `toolroll onboard --starter`
+  switch on Fix failing CI, Issues become tasks and Overnight queue; a task's
+  "Do this every time…" and chat offer the matching one.
+
+## 0.9.0 — 2026-09-30
+
+- **Chat pings only when you're needed.** In Telegram, Slack, Discord and
+  Teams each task is one message, updated in place from filed to Ready (and
+  tasks filed within a minute share one). A new message arrives only when
+  something needs you: a result Ready for review, a question or approval, a
+  failure that needs a decision, a sign-in or plan-limit pause, or a security
+  alert. Choose Only when I'm needed (the default) or Every step, and an
+  optional evening digest, in Settings → Notifications or with
+  `toolroll notifications quiet|all|digest <HH:MM>|digest off`. Delivery
+  receipts and the console's activity are unchanged.
+- **Complete opens a pull request, and Merge is one step.** Turn on pull
+  requests once per project (Projects → Pull requests, or
+  `toolroll publish setup`): Toolroll checks the GitHub remote, the default
+  branch, `gh` sign-in and push rights, and says what to fix. Complete then
+  offers "Complete and open a pull request" beside "Complete only"; the pull
+  request opens from the exact completed commit. The task shows the PR link
+  and its CI. Green reads Ready to merge with one Merge (behind your
+  password; Telegram and Slack link to it), which squashes by default,
+  deletes the branch and records the merge commit in the ledger. Red files
+  one revision with the failing check's name and a fenced log excerpt, at
+  most twice per task, then asks you. "Merge when checks pass" is an
+  opt-in project setting.
+- **Settings → Integrations: what works, what's broken.** One list of
+  Telegram, Slack, Discord, Teams, GitHub, Linear, email, each project's MCP
+  tools, monitoring destinations, Claude and Codex. Each says Connected, Not
+  set up or Broken, with its last success and last error, what uses it, and
+  one action: Set up, Send test, or Fix in plain words. Checks are read-only,
+  run in the background and never hold up a page; `toolroll integrations`
+  shows the same, and `toolroll status` adds a line when something is broken.
+
 ## 0.8.2 — 2026-09-30
 
 - **Task checkouts stop using space nobody wants.** A finished task's clean

package/dist/agent-onboard.d.ts

@@ -8,13 +8,16 @@
  * without running it, and ends with a handoff the agent can relay.
  *
  * Adding the project and writing the skill both need --yes or one yes
- * typed at a terminal. The project is the main checkout (never a linked
+ * typed at a terminal. Then it offers the starter flows (flow-starters.ts),
+ * each switched on by its own yes at a terminal or by --starter; --yes alone
+ * never switches one on. The project is the main checkout (never a linked
  * worktree, the home folder, or one of Toolroll's own worktrees). The skill
  * is replaced by the next onboard and deleted by `onboard --remove` only
  * while it is exactly a version Toolroll wrote; a file of the same name
  * that is not ours, or ours with the person's edits, is never touched.
  */
 import type { ProviderConnection } from "./provider-connection.js";
+import type { StarterView, SwitchedOn } from "./flow-starters.js";
 export type OnboardAgent = "claude" | "codex";
 export declare const ONBOARD_AGENTS: readonly OnboardAgent[];
 export declare const AGENT_NAMES: Record<OnboardAgent, string>;
@@ -119,6 +122,26 @@ export type OnboardIo = {
         message: string;
     }>;
     checkConnection: (agent: OnboardAgent) => Promise<ProviderConnection>;
+    /** Whether the project can open pull requests at Complete, in one line: on, the one command that turns it on, or
+     * what to fix first. Turning it on stays a person's password step. */
+    pullRequests?: (repo: string) => Promise<string>;
+    /** --starter, as typed: a comma list of starter flow ids to switch on. */
+    starterFlag?: string | undefined;
+    /** The project's starter flows, and switching one on — its trigger and zones. */
+    starters?: {
+        list: (repo: string) => Promise<StarterView[]>;
+        switchOn: (repo: string, id: string) => Promise<SwitchedOn>;
+    };
+};
+export type StarterAnswer = {
+    id: string;
+    name: string;
+    summary: string;
+    does: string[];
+    never: string;
+    state: "on" | "switched-on" | "off" | "unavailable" | "failed";
+    flow?: number;
+    said?: string;
 };
 /** Why a found repository cannot be the project, or null when it can. */
 export declare function projectRefusal(found: {

package/dist/agent-onboard.js

@@ -8,7 +8,9 @@
  * without running it, and ends with a handoff the agent can relay.
  *
  * Adding the project and writing the skill both need --yes or one yes
- * typed at a terminal. The project is the main checkout (never a linked
+ * typed at a terminal. Then it offers the starter flows (flow-starters.ts),
+ * each switched on by its own yes at a terminal or by --starter; --yes alone
+ * never switches one on. The project is the main checkout (never a linked
  * worktree, the home folder, or one of Toolroll's own worktrees). The skill
  * is replaced by the next onboard and deleted by `onboard --remove` only
  * while it is exactly a version Toolroll wrote; a file of the same name
@@ -215,6 +217,48 @@ export function loginAccount(file) {
 export function agentReport(agent, connection) {
     return { agent, name: AGENT_NAMES[agent], state: connection.state, words: connectionWords(connection), ...(connection.plan === undefined ? {} : { plan: connection.plan }) };
 }
+/** Offer each starter flow: switch on the ones --starter names, or ask one yes each at a terminal. */
+async function offerStarters(io, repo) {
+    if (io.starters === undefined)
+        return [];
+    const list = await io.starters.list(repo);
+    const named = io.starterFlag === undefined ? null : io.starterFlag.split(",").map(one => one.trim()).filter(one => one !== "");
+    const unknown = named?.filter(one => !list.some(starter => starter.id === one)) ?? [];
+    if (named !== null && (named.length === 0 || unknown.length > 0))
+        return { usage: `--starter takes ${list.map(one => one.id).join(", ")}` };
+    const answers = [];
+    for (const one of list) {
+        const base = { id: one.id, name: one.name, summary: one.summary, does: one.does, never: one.never };
+        if (one.on !== null) {
+            answers.push({ ...base, state: "on", flow: one.on.flow });
+            continue;
+        }
+        if (one.blocked !== null) {
+            answers.push({ ...base, state: "unavailable", said: one.blocked });
+            continue;
+        }
+        const wanted = named !== null ? named.includes(one.id) : io.interactive && !io.json && await io.confirm(`Switch on ${one.name}? ${one.summary} ${one.never} [y/N]`);
+        if (!wanted) {
+            answers.push({ ...base, state: "off" });
+            continue;
+        }
+        const switched = await io.starters.switchOn(repo, one.id);
+        answers.push(switched.ok ? { ...base, state: switched.already ? "on" : "switched-on", flow: switched.flow } : { ...base, state: "failed", said: switched.said });
+    }
+    return answers;
+}
+function starterLines(answers) {
+    return answers.map((one, index) => {
+        const head = index === 0 ? "starters " : "         ";
+        switch (one.state) {
+            case "on": return `${head} ${one.name}: on`;
+            case "switched-on": return `${head} ${one.name}: switched on`;
+            case "unavailable": return `${head} ${one.name}: ${one.said}`;
+            case "failed": return `${head} ${one.name}: ${one.said}`;
+            case "off": return `${head} ${one.name}: ${one.summary} ${one.never} Switch on: toolroll onboard --starter ${one.id}`;
+        }
+    });
+}
 const real = (path) => {
     try {
         return realpathSync(path);
@@ -333,6 +377,10 @@ export async function runOnboard(io) {
     const handoff = buildHandoff({ url: io.url, login: io.login });
     const mcp = agents.map(agent => ({ agent, command: mcpLine(agent) }));
     const projectData = project.state === "added" || project.state === "already" ? { path: project.path, added: project.state === "added" } : null;
+    const pullRequests = projectData === null || io.pullRequests === undefined ? null : await io.pullRequests(projectData.path);
+    const offered = projectData === null ? [] : await offerStarters(io, projectData.path);
+    if (!Array.isArray(offered))
+        return refuse("usage", offered.usage, 2);
     const projectProblem = (() => {
         switch (project.state) {
             case "none": return "not inside a git repository";
@@ -349,6 +397,8 @@ export async function runOnboard(io) {
             command,
             project: projectData,
             ...(projectProblem === null ? {} : { projectProblem }),
+            ...(pullRequests === null ? {} : { pullRequests }),
+            ...(offered.length === 0 ? {} : { starters: offered.map(one => ({ ...one, ...(one.state === "off" ? { command: `toolroll onboard --starter ${one.id}` } : {}) })) }),
             agents: reports,
             skill: skillData,
             mcp,
@@ -361,6 +411,8 @@ export async function runOnboard(io) {
         : project.state === "none" ? "project   none added: run onboard inside the repository you want to hand off" : `project   ${projectProblem}`;
     io.write([
         projectLine,
+        ...(pullRequests === null ? [] : [`pull requests ${pullRequests}`]),
+        ...starterLines(offered),
         `agents    ${reports.map(one => `${one.name}: ${[one.words, one.plan].filter(Boolean).join(" · ")}`).join("; ")}`,
         skillLine(),
         ...mcp.map((one, index) => `${index === 0 ? "tools    " : "         "} ${one.command}   (add Toolroll as tools; not run)`),

package/dist/backup-ui.js

@@ -1,9 +1,11 @@
 import { bytesWords } from "./storage.js";
+import { whenUtc } from "./when-html.js";
 /** The schedules on offer and the most copies kept. Here rather than in backup.ts so the page never loads `node:sqlite`. */
 export const BACKUP_EVERY_HOURS = [1, 6, 12, 24];
 export const MAX_KEEP = 100;
 const e = (value) => String(value ?? "").replace(/[&<>"']/g, c => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
-const when = (at) => `${e(at.slice(0, 16).replace("T", " "))} UTC`;
+const when = (at) => whenUtc(at);
+const whenWords = (at) => `${at.slice(0, 16).replace("T", " ")} UTC`;
 const everyWords = (hours) => hours === 1 ? "Every hour" : hours === 24 ? "Every day" : `Every ${hours} hours`;
 const fileName = (path) => path.slice(path.lastIndexOf("/") + 1);
 export const BACKUP_CSS = `.backups{max-width:720px;min-width:0;overflow-wrap:anywhere}.backups .backup-state{display:flex;gap:16px;align-items:flex-start;justify-content:space-between;flex-wrap:wrap}` +
@@ -22,7 +24,7 @@ function state(view) {
     const good = view.runs.find(one => one.ok === true);
     const next = !view.settings.enabled ? "Scheduled backups are off."
         : good === undefined ? "The first scheduled backup runs within a minute or two of the console starting."
-            : `Next one about ${when(new Date(Date.parse(good.startedAt) + view.settings.everyHours * 3_600_000).toISOString())}.`;
+            : `Next one about ${whenWords(new Date(Date.parse(good.startedAt) + view.settings.everyHours * 3_600_000).toISOString())}.`;
     if (last === undefined)
         return `<h2>No backups yet</h2><p class="meta">${e(next)}</p>`;
     if (last.ok === null)