local-kanban 2.0.0-beta.1 → 2.0.0-beta.3

package/CHANGELOG.md

@@ -8,6 +8,81 @@ version it goes out as and opens an empty one again. Released sections are histo
 
 ## [Unreleased]
 
+## [2.0.0-beta.3]
+
+### Fixed
+
+- The mark «on main» counts a squash and a copy under another subject as shipped, no longer reads the head of the project, a foreign pull request or a mere mention as a task's commit, does not call a branch that took its work back shipped, finds a key after a number in the subject, costs a look a few git processes instead of four a commit, and leaves no objects in the project's repository.
+- Ready to ship: Prep and a label set on the way are no road past the column; an emptied column goes at once; the Dashboard's «Waiting for you» lists what waits for your word, with its number in the sidebar; Done with Claude and the first-run tour know the column; a guest of the Wi-Fi board cannot change a project's own word.
+- A label or a move the board refuses no longer holds the rest of the card: the label comes off with the reason said, and what you typed is saved in any order, after a lost connection and with the card closed too.
+- A guest of the Wi-Fi board is told that only the owner can do this, instead of «the board did not accept it».
+- **Wi-Fi: a guest could get the key out of a backup.** Backups hold the whole database, the key of the door with it, and a guest with a pass could take one and download it. Backups now stay with the owner, the list too, and Settings → Backups tells a guest so; About no longer gives a guest the paths on disk.
+- **Wi-Fi: the key no longer stays behind in the page of the board.** A link opens the board by a redirect, so a script there finds nothing of the key in `document.referrer`, and Back does not lead to its address. A right key on a long address opens the board instead of an empty page, and a guest with words typed when the key changes is told to copy them and reload.
+- The screens the terminal keeps to send only what changed take less memory and go when nobody looks.
+- A comment is no longer written twice when you press send again while it waits, or «Send back» again with the same reason. One written with its answer lost no longer stands under itself as «not sent», and one deleted before the resend stays deleted.
+- Automations: a board that has just restarted no longer types into a question or a limit screen it has not read yet, and going on with interrupted work leaves alone what is typed in the field, a task that left work and a session a day old; a card says the board went on only when the words got there.
+- Automations: «Did not start» says in the board's language that a Claude already works on the tasks, or that tmux did not answer.
+- `kb show A B`: a card whose comments did not load says it is cut short, and a refusal leaves no `---` behind.
+- `kb note` no longer reports a failure for a note it saved, and an answer of the board that breaks off in the middle exits with code 4, not as a failure of `kb` itself.
+- A release check names the file and line of what it found, and a broken private file of patterns is said in words.
+- A release runs the test of the mark «on main» after the rest of the suite, not beside it: on a Mac the two together failed tmux tests at random and stopped the release.
+
+## [2.0.0-beta.2]
+
+### Added
+
+- A status «Ready to ship» between Doing and Deploying, off by default: with the switch in Settings → Statuses a finished task waits for your word, and the board itself refuses Deploying past it, and Doing straight to Review. A project can say otherwise in its settings.
+- A mark on the cards of Ready to ship and Review: on main, only in a branch or no commits found, and a filter of Review for what is not on main.
+
+### Fixed
+
+- The chat shows helpers and workflows at work: those started without the background flag, those brought back after a stop, and those that woke after finishing.
+- The terminal sends what changed on the screen instead of the whole screen every second: far less traffic on a phone.
+- The symbol background holds no video memory while it is off, and resizing the window no longer piles up canvases.
+- Scrolling a column with many link lines no longer rewrites all of them on every frame.
+- A comment whose answer got lost on the way is no longer written twice when the page sends it again.
+- Automations: a restart of the board no longer loses the words that tell an interrupted Claude to go on, and a limit line left on the screen past its moment does not hold them.
+- Automations: after a refused start, «Next batch in» counts down to the next try instead of standing at 0:00 for five minutes.
+- `kb show A B` prints every card, a line of `---` between them; it used to print the first one and drop the rest with code 0.
+- **Automations.** The fix of a returned task no longer waits hours for the terminals at their prompts; the grooming's Claude is
+  not closed while it asks you; one held task does not stop a batch; a blocked or `ask` task is not resumed.
+- **Words kept.** A last word in a checklist item is not overwritten by a late resend, a failed save of the description no longer
+  claims someone else changed it, and words typed into a question that went away come back by themselves.
+- **Phones and failures.** A phone on its side keeps the back gesture on the page, a phone says when the projects did not load,
+  a stream that never opened is announced, and a device stopped at the key page is listed in Turned away.
+- **Sessions.** Only a move of the status takes a task over: a note or a field edited from another session does not.
+
+### Changed
+
+- **Automations watch the size of CLAUDE.md.** A switch opens a task in a project's backlog when its CLAUDE.md is past the
+  norm of Health; you start it yourself, and a task you cancelled does not come back.
+- **A summary when you come back.** With automations on, the first look after eight hours of silence shows what was handed
+  in, accepted, returned or got stuck, each line opening its card.
+- **Automations take the queue and a schedule.** Once a marked project is finished its next batch of To do starts, at most 5
+  tasks and not over 80% of the limit; a check of Review or the grooming of the backlog can run at a set time. A run the
+  sleeping computer missed is skipped.
+- **A repeating automation can fix what its check returns.** A returned task goes back to work in a new session and the
+  check comes after it, at most 2 rounds; then the task waits for you.
+- **The board can go on with interrupted work by itself.** A switch in Automations: once the limit has reset or the Mac is
+  up, a session cut off mid-work goes on, one a minute, at most 3 times in a row, and never one that waits for you.
+- **An automation can repeat, and one form covers several projects.** A repeating rule stays after its check and waits for
+  the next batch, at most 10 checks a day; tick any projects, or all of them, and each gets its rule. At most two checks
+  run on the board at once, the others wait for a place.
+- **The board over Wi-Fi opens by a key again.** The QR code and the link carry it, and a browser without them is asked for
+  it, so a home-screen app or a private tab is never locked out: the 16 characters can be typed by hand, and the device
+  remembers. Settings → Wi-Fi shows the key and changes it. Everyone connected by the plain address needs the new link.
+- **Markdown files open in a window.** A `.md` file Claude wrote or edited opens from the list of changed files in the
+  chat, rendered and readable at the width of a page, on a phone too.
+- **A card opens with its chat closed.** It used to open on the chat and scroll to its end, taking the title and the
+  description out of sight; now the chat opens from its tab, from ▶ or from «Open in the card».
+
+### Fixed
+
+- **Words typed in a chat survive Claude moving to its next task.** In a column of Terminals the field emptied and the
+  chat blinked «Loading…» whenever the session took the next task of its batch; the words now stay and the chat stands still.
+- **Claude's last words stay in sight when its turn ends on a step.** A turn that ended by sending helpers or a command to
+  the background folded all its text behind the «Worked for» bar.
+
 ## [2.0.0-beta.1]
 
 **2.0 beta.** The board stopped being a list of tasks next to Claude and became the place you work with it: Claude starts

package/README.md

@@ -134,7 +134,7 @@ Claude on it — the report stays on the card of the check.
 
 The server listens on **127.0.0.1 only** and has **no authentication**. The board is strictly local: your machine is the trust boundary. **Never expose the port to the network** (no reverse proxies, no `0.0.0.0`, no port forwarding). Third-party integrations should run on the same machine and talk to `127.0.0.1` (see [docs/API.md](docs/API.md)).
 
-The one exception is your own switch: **Settings → Wi-Fi** opens a separate door on the local network (port + 10, `KB_SHARE_PORT`) for people you show its QR code to. Only the link's secret lets anyone in, and with it a guest can do on the board everything you can — including talking to Claude on your computer. It is off by default; switching it off closes the door, a new link drops every guest.
+The one exception is your own switch: **Settings → Wi-Fi** opens a separate door on the local network (port + 10, `KB_SHARE_PORT`) for people you show its QR code to. Only its key lets anyone in: in the link of the QR code, or typed by hand when a browser has no link. With it a guest can do on the board everything you can — including talking to Claude on your computer. The connection is plain HTTP, so the key keeps people out but does not encrypt the traffic: switch the door off on a network of strangers. It is off by default; switching it off closes the door, a new key drops every guest.
 
 **The board holds no credentials.** A project can name an SSH host to deploy to, but neither a key
 nor a password is ever entered here: the board simply runs `ssh <host>`, and who you are, on which

package/README.ru.md

@@ -133,7 +133,7 @@ local-kanban start      # доска на http://localhost:3100
 
 Сервер слушает **только 127.0.0.1**, авторизации **нет**. Доска строго локальная: граница доверия — твоя машина. **Никогда не выставляй порт наружу** (никаких reverse proxy, `0.0.0.0`, проброса портов). Сторонние интеграции запускаются на той же машине и ходят на `127.0.0.1` (см. [docs/API.md](docs/API.md)).
 
-Исключение одно — твой выключатель: **«Настройки → Wi-Fi»** открывает отдельный вход в локальной сети (порт + 10, `KB_SHARE_PORT`) для тех, кому ты покажешь QR-код. Пускает только секрет ссылки, а с ним гость может на доске всё то же, что и ты, — в том числе писать Claude на твоём компьютере. По умолчанию выключено; выключатель закрывает вход, новая ссылка отключает всех гостей.
+Исключение одно — твой выключатель: **«Настройки → Wi-Fi»** открывает отдельный вход в локальной сети (порт + 10, `KB_SHARE_PORT`) для тех, кому ты покажешь QR-код. Пускает только ключ: он в ссылке QR-кода, а в браузере без ссылки его можно ввести руками. С ним гость может на доске всё то же, что и ты, — в том числе говорить с Claude на твоём компьютере. Соединение идёт простым HTTP: ключ не пускает посторонних, но не шифрует трафик, поэтому в сети с чужими людьми вход выключай. По умолчанию он закрыт; выключатель закрывает вход, а новый ключ выкидывает всех гостей.
 
 **Доска не хранит доступов.** У проекта можно указать ssh-хост, куда он выкатывается, но ни ключ, ни
 пароль здесь не вводятся: доска просто запускает `ssh <хост>`, а кто ты, на каком порту и с каким

package/bin/kb

@@ -14,14 +14,14 @@ const PRI_BY_NAME = { none: 0, low: 1, med: 2, medium: 2, high: 3, p0: 0, p1: 1,
 const ST_ALIAS = {
   b: 'backlog', backlog: 'backlog', t: 'todo', todo: 'todo',
   pp: 'prep', prep: 'prep', d: 'doing', doing: 'doing',
-  dp: 'deploy', deploy: 'deploy', r: 'review', review: 'review', dn: 'done', done: 'done',
+  rd: 'ready', ready: 'ready', dp: 'deploy', deploy: 'deploy', r: 'review', review: 'review', dn: 'done', done: 'done',
   c: 'cancelled', cancelled: 'cancelled', cancel: 'cancelled',
 };
 
 // Exit codes are a contract for automation (scripts gate their moves on them):
 // 0 — success, 1 — the board is not responding, 2 — the request was rejected (4xx or an
 // unknown command), 3 — kb itself broke, 4 — the board answered, but with a failure of its
-// own (5xx) or with something that is not JSON, or not of the shape the board answers with.
+// own (5xx) or with something that is not JSON, not of the shape the board answers with, or cut off.
 // Previously an exception exited with 1 as well, so "the board is down" was indistinguishable from
 // "kb is broken".
 // Code 4 exists because 2 was answering two different questions at once. A live board that
@@ -99,7 +99,11 @@ async function api(method, path, body, expect = null) {
     return data;
   };
   if (res.status === 204) return shaped(null);
-  const text = await res.text();
+  // Headers came and the body did not finish: the board went down in the middle of its answer. That throws here,
+  // past the check above, and read as kb itself breaking.
+  let text;
+  try { text = await res.text(); }
+  catch { die(`kb: the board answered ${res.status} and broke off in the middle — whether it did what was asked is not known`, EXIT.BOARD_ERROR); }
   let data = null;
   let parsed = false;
   try { data = JSON.parse(text); parsed = true; } catch { /* not JSON — see below */ }
@@ -409,7 +413,7 @@ const commands = {
     const ps = await api('GET', '/api/projects', null, LIST);
     if (!ps.length) return console.log('no projects');
     for (const p of ps) {
-      console.log(`${p.slug} (${p.prefix}) b${p.c_backlog || 0} t${p.c_todo || 0} pp${p.c_prep || 0} d${p.c_doing || 0} dp${p.c_deploy || 0} r${p.c_review || 0} ✓${p.c_done || 0}${p.c_blocked ? ` !${p.c_blocked}` : ''}`);
+      console.log(`${p.slug} (${p.prefix}) b${p.c_backlog || 0} t${p.c_todo || 0} pp${p.c_prep || 0} d${p.c_doing || 0}${p.c_ready ? ` rd${p.c_ready}` : ''} dp${p.c_deploy || 0} r${p.c_review || 0} ✓${p.c_done || 0}${p.c_blocked ? ` !${p.c_blocked}` : ''}`);
     }
   },
 
@@ -471,21 +475,38 @@ const commands = {
     console.log(`${t.key} review 📝`);
   },
 
+  // A batch is read in one go, so every key is printed, cards apart by a line of ---. A wrong key stops the
+  // command before the first request; a task the board does not know stops it there, and says at which key.
+  // The line goes out once the next card is read, so a refused one leaves none hanging, and a card whose comments
+  // did not come is called cut short: its head is printed, and it does not look like a whole one.
   async show() {
-    const [id] = args;
-    if (!id) die('kb show <key>');
-    const t = await api('GET', `/api/tasks/${key(id)}`, null, TASK);
-    console.log(`${t.key} ${t.project} ${t.status}${t.pinned ? ' ' + PIN : ''}${t.blocked ? ` blocked: ${t.blocked_reason || ''}` : ''}${PRI[t.priority] ? ' ' + PRI[t.priority] : ''}${t.labels.length ? ' [' + t.labels.join(',') + ']' : ''}`);
-    console.log(t.title);
-    if (t.description) console.log(t.description);
-    printChecklist(t);
-    printLinks(t);
-    printIssue(t);
-    printMoves(t);
-    printSessions(t);
-    printUsage(t);
-    printAttachments(t);
-    printComments(await api('GET', `/api/tasks/${t.id}/comments`, null, LIST), 5);
+    if (!args.length) die('kb show <key> [<key> …]');
+    const ids = args.map(key);
+    let at = 0;
+    let cut = null;
+    process.on('exit', (code) => {
+      if (!code) return;
+      const part = cut ? `${cut} is cut short — its comments did not load` : '';
+      if (ids.length > 1) process.stderr.write(`kb: stopped at ${args[at]}: ${at} of ${ids.length} printed${part ? `, ${part}` : ''}\n`);
+      else if (part) process.stderr.write(`kb: ${part}\n`);
+    });
+    for (; at < ids.length; at++) {
+      const t = await api('GET', `/api/tasks/${ids[at]}`, null, TASK);
+      if (at) console.log('---');
+      console.log(`${t.key} ${t.project} ${t.status}${t.pinned ? ' ' + PIN : ''}${t.blocked ? ` blocked: ${t.blocked_reason || ''}` : ''}${PRI[t.priority] ? ' ' + PRI[t.priority] : ''}${t.labels.length ? ' [' + t.labels.join(',') + ']' : ''}`);
+      console.log(t.title);
+      if (t.description) console.log(t.description);
+      printChecklist(t);
+      printLinks(t);
+      printIssue(t);
+      printMoves(t);
+      printSessions(t);
+      printUsage(t);
+      printAttachments(t);
+      cut = t.key;
+      printComments(await api('GET', `/api/tasks/${t.id}/comments`, null, LIST), 5);
+      cut = null;
+    }
   },
 
   async add() {
@@ -506,7 +527,7 @@ const commands = {
     }
     if (si >= 0) {
       body.status = ST_ALIAS[args[si + 1]];
-      if (!body.status) die('kb: status backlog|todo|prep|doing|deploy|review|done');
+      if (!body.status) die('kb: status backlog|todo|prep|doing|ready|deploy|review|done');
     }
     const t = await api('POST', '/api/tasks', body, TASK);
     console.log(`${t.key} ${t.status} ${t.project}`);
@@ -515,7 +536,7 @@ const commands = {
   async mv() {
     const [id, st] = args;
     const status = ST_ALIAS[st];
-    if (!id || !status) die('kb mv <key> backlog|todo|prep|doing|deploy|review');
+    if (!id || !status) die('kb mv <key> backlog|todo|prep|doing|ready|deploy|review');
     const k = key(id);
     // started by the board runs only after asking (src/phantom.js), while its `kb mv` goes without asking. Before
     // this, `kb mv <key> done` sent the very request of `kb done` and skipped the question.
@@ -582,9 +603,10 @@ const commands = {
   async note() {
     const [id, body] = args;
     if (!id || !body) die('kb note <key> "text"');
+    // Nothing is read after the write: a read that failed reported a failure of a note already saved, and the retry
+    // wrote a second one. So the key is printed as it was typed.
     await api('POST', `/api/tasks/${key(id)}/comments`, { body, author: 'claude' }, COMMENT);
-    const t = await api('GET', `/api/tasks/${key(id)}`, null, TASK);
-    console.log(`${t.key} 📝`);
+    console.log(`${id} 📝`);
   },
 
   // kb link A B [child|parent|related] — `child`: B becomes a sub-task of A, `parent`: B becomes
@@ -650,6 +672,7 @@ const commands = {
     if (p.domain) out.push(`domain: ${p.domain}`);
     // CLAUDE.md", "deployed by skill X", DNS facts) — info printed everything but it
     if (p.description) out.push(`description: ${p.description}`);
+    if (p.ship_gate) out.push('ships on the word: after the commit kb mv <key> ready and wait; deploy only once the person says so');
     // page; without this line Claude went looking by itself and sometimes missed. A missing
     // CLAUDE.md is said out loud — it is a signal (the task starts without architecture notes).
     if (p.path) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "local-kanban",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.3",
   "license": "MIT",
   "author": "Dannylamao",
   "repository": {

package/public/js/automations.js

@@ -8,14 +8,16 @@ import { checkWords } from './review.js';
 import { getSetting, openSettingsModal } from './settings.js';
 import { renderSidebar, selectProject, styledAlert } from './sidebar.js';
 import { refusalLine } from './unsaved.js';
+import { failWord } from './review-rules.js';
 
+const CHECK_KIND = 'finished-check';
+const SCHEDULED = new Set(['schedule-check', 'schedule-groom']);
 let auto = { on: false, rules: [] };
 let skew = 0; // the server's clock minus ours: a guest's phone may run off the Mac's
 /** The last view of the server: {on, rules}. */
 export const automations = () => auto;
-/** The armed rules (one per project at most). */
 export const armedRules = () => (auto.on ? auto.rules.filter((r) => r.state === 'armed') : []);
-const armedOf = (slug) => armedRules().find((r) => r.project === slug) || null;
+const armedOf = (slug) => armedRules().find((r) => r.project === slug && r.kind === CHECK_KIND) || null; // what ▶ of Review waits for
 
 /** Read the view from the server; quiet — the board works the same without it. */
 export async function loadAutomations() {
@@ -26,7 +28,7 @@ export function applyAutomations(v) {
   if (!v || !Array.isArray(v.rules)) return;
   const sig = (x) => JSON.stringify([x.on, x.rules.filter((r) => r.state === 'armed').length]);
   const sidebar = sig(v) !== sig(auto);
-  auto = { on: Boolean(v.on), rules: v.rules };
+  auto = { on: Boolean(v.on), rules: v.rules, extras: v.extras || {} };
   if (typeof v.now === 'number') skew = v.now - Date.now();
   if (sidebar) renderSidebar();
   if (state.slug === AUTO && $('automations')) paint();
@@ -52,19 +54,26 @@ function tick() {
 const keysOf = (r) => (r.keys || []).join(', ');
 /** What an armed rule waits for, in the board's words. */
 export function phaseLine(r) {
-  if (r.phase === 'ready' && r.due_at) return `${tr('Check in')} <span class="auto-due" data-due="${r.due_at}">${mmss(left(r.due_at))}</span>`;
+  if (r.phase === 'ready' && r.due_at) return `${tr(r.kind === 'todo-queue' ? 'Next batch in' : 'Check in')} <span class="auto-due" data-due="${r.due_at}">${mmss(left(r.due_at))}</span>`;
   const say = {
     idle: tr('Waits for Claude to take up tasks of the project'),
     working: `${tr('Claude is at work:')} ${esc(keysOf(r))}`,
     ready: tr('Claude has finished — the pause begins'),
+    planned: `${tr('Next run:')} ${esc(r.plan?.at || '')}`,
   }[r.phase];
   if (say) return say;
   const held = {
+    'at-work': `${tr('Claude is at work:')} ${esc(keysOf(r))}`,
     question: `${tr('Waits for you: a question of Claude in')} ${esc(keysOf(r))}`,
     ask: `${tr('Waits for you: Claude asks in')} ${esc(keysOf(r))}`,
     'sent-back': `${tr('Waits for you: back in To do —')} ${esc(keysOf(r))}`,
     limit: tr('Waits for the subscription limit to reset'),
     'check-open': `${tr('The project already has an open check')} ${esc(keysOf(r))}`,
+    'day-cap': `${tr('The checks of the day are used up:')} ${r.fires_max}`,
+    busy: tr('Waits for a place: enough checks run on the board now'),
+    'limit-high': tr('Waits: over 80% of the subscription limit is used'),
+    'queue-empty': tr('Nothing to take in To do'),
+    unfinished: `${tr('Waits: the work in the project was cut off —')} ${esc(keysOf(r))}`,
     nothing: tr('Nothing in Review to check'),
     off: tr('Automations are switched off in Settings'),
   }[r.reason];
@@ -72,43 +81,103 @@ export function phaseLine(r) {
 }
 const phaseText = (r) => { const d = document.createElement('div'); d.innerHTML = phaseLine(r); return d.textContent; };
 const hm = (ms) => { const d = new Date(ms); return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`; };
-const FAIL_WORDS = {
-  'no-folder': 'the project has no folder on this computer',
-  'no-tmux': 'tmux is not installed here',
-  'no-claude': 'Claude Code is not installed here',
-  'too-long': 'the prompt is too long for the board\'s terminal',
-  'check-open': 'the project already has an open check',
-  manual: 'a task done by hand cannot be given to Claude',
-};
+const failWhy = (r) => { const word = failWord(r.error); return word ? tr(word) : esc(r.error || ''); };
 function endedLine(r) {
   const key = r.check_key ? `<button type="button" class="auto-key" data-key="${esc(r.check_key)}">${esc(r.check_key)}</button>` : '';
   if (r.state === 'fired') return `${tr('Check started')} ${key} · ${hm(r.ended_at)}`;
   if (r.state === 'covered') return `${tr('The check was started by hand:')} ${key} · ${hm(r.ended_at)}`;
   if (r.state === 'cancelled') return `${tr('Taken off')} · ${hm(r.ended_at)}${/^archived:/.test(r.error || '') ? `: ${tr('the project was archived')}` : ''}`;
-  const reason = String(r.error || '').match(/^([a-z-]+): /)?.[1];
-  const why = reason && FAIL_WORDS[reason] ? tr(FAIL_WORDS[reason]) : esc(r.error || '');
-  return `${tr('Did not start')} · ${hm(r.ended_at)}: ${why}${key ? ` · ${tr('the check waits in To do:')} ${key}` : ''}`;
+  return `${tr('Did not start')} · ${hm(r.ended_at)}: ${failWhy(r)}${key ? ` · ${tr('the check waits in To do:')} ${key}` : ''}`;
 }
 
 /* ── the section ── */
 const projectName = (slug) => { const p = state.projects.find((x) => x.slug === slug); return p ? (p.name || p.slug) : slug; };
-const ruleWhat = (r) => `${tr('When')} <b>${esc(r.project_name || projectName(r.project))}</b> ${tr('finishes, wait')} ${Math.round(r.delay_s / 60)} ${tr('min and check Review')}`;
+const DAYS = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+const whenWords = (plan) => `${plan?.day === null || plan?.day === undefined ? tr('Every day') : tr(DAYS[plan.day])}, ${esc(plan?.at || '')}`;
+const ruleWhat = (r) => (r.kind === 'todo-queue' ? `${tr('When')} <b>${esc(r.project_name || projectName(r.project))}</b> ${tr('finishes, wait')} ${Math.round(r.delay_s / 60)} ${tr('min and start the next batch of To do')}`
+  : r.kind === 'schedule-check' ? `<b>${esc(r.project_name || projectName(r.project))}</b>: ${tr('a check of Review')} · ${whenWords(r.plan)}`
+    : r.kind === 'schedule-groom' ? `<b>${esc(r.project_name || projectName(r.project))}</b>: ${tr('the grooming of the backlog')} · ${whenWords(r.plan)}` : checkWhat(r));
+const checkWhat = (r) => `${tr('When')} <b>${esc(r.project_name || projectName(r.project))}</b> ${tr('finishes, wait')} ${Math.round(r.delay_s / 60)} ${tr(r.repeat ? 'min and check Review, every time' : 'min and check Review')}${r.fix ? `, ${tr('fixing what comes back')}` : ''}`;
 
+const KIND_NAMES = [
+  [CHECK_KIND, 'A check once Claude has finished'], ['todo-queue', 'The next batch of To do'],
+  ['schedule-check', 'A check of Review on a schedule'], ['schedule-groom', 'The grooming of the backlog on a schedule'],
+];
+const KIND_HINTS = {
+  [CHECK_KIND]: 'Starts when every task Claude took in the project has reached Review and nothing waits for you. Like ▶ on the Review column — Claude inside the board, with the permissions and effort of Settings → Claude Code.',
+  'todo-queue': 'At most 5 tasks by priority, without ask and noclaude; it does not start while over 80% of the 5-hour or the weekly limit is used, nor over a question of Claude.',
+  'schedule-check': 'If the computer sleeps at that time the run is skipped until the next one. It does not start over work going on in the project.',
+  'schedule-groom': 'Claude prepares the backlog and moves no tasks. If the computer sleeps at that time the run is skipped until the next one.',
+};
+let formKind = CHECK_KIND;
+let formDay = 'every';
 function newRuleHTML() {
   return '<div class="panel auto-new">'
     + `<div class="auto-h">${ic('bolt', 14)} ${tr('New automation')}</div>`
-    + '<div class="auto-sentence">'
-    + `<span>${tr('When')}</span><div class="kbsel auto-proj" id="auto-proj"></div><span>${tr('finishes its work,')}</span>`
+    + `<div class="auto-sentence"><div class="kbsel auto-kind" id="auto-kind"></div></div>`
+    + `<div class="auto-sentence" data-for="wait"><span>${tr('When the project finishes its work,')}</span>`
     + `<span>${tr('wait')}</span><input type="number" id="auto-min" class="auto-min" min="0" max="120" step="1" value="3" inputmode="numeric" aria-label="${esc(tr('minutes'))}"><span>${tr('min')}</span>`
-    + `<span>${tr('and start a check of the tasks in Review')}</span></div>`
-    + `<div class="muted auto-hint">${tr('Runs once: when every task Claude took in the project has reached Review and nothing waits for you. Like ▶ on the Review column — Claude inside the board, with the permissions and effort of Settings → Claude Code.')}</div>`
+    + `<span id="auto-then"></span></div>`
+    + `<div class="auto-sentence" data-for="plan"><span>${tr('At')}</span><input type="time" id="auto-at" class="auto-min auto-at" value="03:00" aria-label="${esc(tr('Time'))}"><div class="kbsel auto-day" id="auto-day"></div></div>`
+    + `<div class="auto-picks-h"><span>${tr('Projects')}</span><button type="button" class="auto-all" id="auto-all"></button></div>`
+    + '<div class="auto-picks" id="auto-picks"></div>'
+    + `<label class="set-row auto-repeat" data-for="check"><span class="set-lab">${tr('Repeat')}<small>${tr('after a check the rule waits for the next batch, until you take it off')}</small></span><input type="checkbox" class="set-toggle" id="auto-repeat" checked></label>`
+    + `<label class="set-row auto-repeat" data-for="check" id="auto-fix-row"><span class="set-lab">${tr('Fix what the check returns')}<small>${tr('the board starts a returned task in a new session and the check comes after it, at most 2 rounds; then the task waits for you')}</small></span><input type="checkbox" class="set-toggle" id="auto-fix"></label>`
+    + '<div class="muted auto-hint" id="auto-hint"></div>'
     + `<div class="auto-actions"><button type="button" class="btn-primary" id="auto-add">${tr('Add')}</button></div>`
     + '</div>';
 }
+/** The form for the kind of rule chosen. */
+function paintKind() {
+  const shows = { wait: !SCHEDULED.has(formKind), plan: SCHEDULED.has(formKind), check: formKind === CHECK_KIND };
+  document.querySelectorAll('.auto-new [data-for]').forEach((el) => { el.classList.toggle('hidden', !shows[el.dataset.for]); });
+  $('auto-then').textContent = tr(formKind === CHECK_KIND ? 'and start a check of the tasks in Review' : 'and start the next batch of To do');
+  $('auto-hint').textContent = tr(KIND_HINTS[formKind]);
+  if (formKind === CHECK_KIND) $('auto-fix-row').classList.toggle('hidden', !$('auto-repeat').checked);
+}
+function wireForm() {
+  buildSelect($('auto-kind'), { value: formKind, options: KIND_NAMES.map(([value, label]) => ({ value, label: tr(label) })),
+    onChange: (v) => { formKind = v; freeSig = ''; paintKind(); paint(); } });
+  buildSelect($('auto-day'), { value: formDay, options: [{ value: 'every', label: tr('Every day') }, ...[1, 2, 3, 4, 5, 6, 0].map((d) => ({ value: String(d), label: tr(DAYS[d]) }))],
+    onChange: (v) => { formDay = v; } });
+  paintKind();
+}
+const EXTRAS = [
+  ['resume', 'Go on with interrupted work', 'once the limit has reset or the Mac is up: all sessions, at most 3 times in a row, one a minute; never one that waits for you'],
+  ['health', 'Watch the size of CLAUDE.md', 'a file past the norm of Health gets a task in the backlog of its project, once a day; you start it yourself'],
+];
+function extrasHTML() {
+  return `<div class="panel auto-extras"><div class="auto-h">${ic('bolt', 14)} ${tr('By itself')}</div>`
+    + EXTRAS.map(([k, name, hint]) => `<label class="set-row auto-repeat"><span class="set-lab">${tr(name)}<small>${tr(hint)}</small></span><input type="checkbox" class="set-toggle" data-extra="${k}"></label>`).join('')
+    + '</div>';
+}
+function paintExtras() {
+  document.querySelectorAll('[data-extra]').forEach((b) => { if (!b.disabled) b.checked = Boolean(auto.extras?.[b.dataset.extra]); });
+}
+function wireExtras() {
+  document.querySelectorAll('[data-extra]').forEach((b) => {
+    b.onchange = async () => {
+      b.disabled = true;
+      const launch = { permission: getSetting('permission'), effort: startEffort(false, getSetting('effort'), getSetting('effortCheck')) || undefined };
+      try { const v = await api('PUT', '/api/automations/extras', { [b.dataset.extra]: b.checked, launch }, { quiet: true }); b.disabled = false; applyAutomations(v); } catch (e) {
+        b.disabled = false;
+        b.checked = !b.checked;
+        styledAlert(refusalLine('Could not change the automation', e, tr));
+      }
+    };
+  });
+}
+
+function repeatLine(r) {
+  if (!r.repeat || !(r.fires_n || r.error)) return '';
+  const key = r.check_key ? ` · <button type="button" class="auto-key" data-key="${esc(r.check_key)}">${esc(r.check_key)}</button>` : '';
+  if (r.error) return `<div class="auto-phase">${tr('Did not start')}: ${failWhy(r)}${r.check_key && r.check_status === 'todo' ? ` · ${tr('the check waits in To do:')}${key.slice(2)}` : ''}</div>`;
+  return `<div class="auto-phase">${tr('Checks in the last day:')} ${r.fires_n} / ${r.fires_max}${key}</div>`;
+}
 function armedHTML(r) {
   return `<div class="panel auto-rule" data-id="${r.id}">`
     + `<div class="auto-rule-main"><div class="auto-what">${ruleWhat(r)}</div>`
-    + `<div class="auto-phase${r.phase === 'ready' ? ' auto-ready' : ''}">${phaseLine(r)}</div></div>`
+    + `<div class="auto-phase${r.phase === 'ready' ? ' auto-ready' : ''}">${phaseLine(r)}</div>${repeatLine(r)}</div>`
     + `<button type="button" class="btn-ghost auto-drop" data-id="${r.id}">${tr('Take off')}</button></div>`;
 }
 function endedHTML(r) {
@@ -117,7 +186,7 @@ function endedHTML(r) {
     + `<button type="button" class="btn-icon auto-forget" data-id="${r.id}" title="${esc(tr('Remove from the list'))}" aria-label="${esc(tr('Remove from the list'))}">✕</button></div>`;
 }
 
-let picked = '';
+const picked = new Set();
 let freeSig = '';
 /* The form is drawn once per opening and kept: the section repaints on every event of the board (it is a special view,
    and the 5 s look of the server sends its own), and a form drawn anew took the focus out of the minutes field and
@@ -134,23 +203,32 @@ function paint() {
   }
   if (box.dataset.mode !== 'on' || !$('auto-list')) {
     box.dataset.mode = 'on';
-    box.innerHTML = `<div class="now-wrap">${newRuleHTML()}<div id="auto-list" class="auto-list"></div></div>`;
+    box.innerHTML = `<div class="now-wrap">${newRuleHTML()}${extrasHTML()}<div id="auto-list" class="auto-list"></div></div>`;
+    wireExtras();
     freeSig = '';
     $('auto-add').onclick = () => addRule($('auto-add'));
+    $('auto-repeat').onchange = paintKind;
+    wireForm();
+    $('auto-all').onclick = () => {
+      const boxes = [...document.querySelectorAll('#auto-picks input')];
+      const all = boxes.every((b) => b.checked);
+      for (const b of boxes) { b.checked = !all; if (all) picked.delete(b.value); else picked.add(b.value); }
+      paintPicks();
+    };
   }
+  paintExtras();
   const armed = auto.rules.filter((r) => r.state === 'armed');
   const past = auto.rules.filter((r) => r.state !== 'armed');
-  const free = state.projects.filter((p) => !p.archived && !armed.some((r) => r.project === p.slug));
+  const free = state.projects.filter((p) => !p.archived && !armed.some((r) => r.project === p.slug && r.kind === formKind));
   const sig = JSON.stringify(free.map((p) => [p.slug, p.name]));
-  if (sig !== freeSig && !$('auto-proj').classList.contains('open')) {
+  if (sig !== freeSig) {
     freeSig = sig;
-    if (!free.some((p) => p.slug === picked)) picked = free.find((p) => p.slug === state.lastProject)?.slug || free[0]?.slug || '';
-    buildSelect($('auto-proj'), {
-      value: picked, placeholder: tr('no project is free'), search: free.length > 8,
-      options: free.map((p) => ({ value: p.slug, label: p.name || p.slug })),
-      onChange: (v) => { picked = v; },
-    });
-    $('auto-add').disabled = !free.length;
+    for (const slug of picked) if (!free.some((p) => p.slug === slug)) picked.delete(slug);
+    if (!picked.size) { const first = free.find((p) => p.slug === state.lastProject) || free[0]; if (first) picked.add(first.slug); }
+    $('auto-picks').innerHTML = free.map((p) => `<label class="auto-pick"><input type="checkbox" value="${esc(p.slug)}"${picked.has(p.slug) ? ' checked' : ''}><span>${esc(p.name || p.slug)}</span></label>`).join('')
+      || `<span class="muted">${tr('no project is free')}</span>`;
+    $('auto-picks').querySelectorAll('input').forEach((b) => { b.onchange = () => { if (b.checked) picked.add(b.value); else picked.delete(b.value); paintPicks(); }; });
+    paintPicks();
   }
   const list = $('auto-list');
   keepFocus(list, () => {
@@ -161,22 +239,41 @@ function paint() {
   list.querySelectorAll('.auto-key').forEach((b) => { b.onclick = () => openDrawer(b.dataset.key); });
 }
 
+function paintPicks() {
+  const boxes = [...document.querySelectorAll('#auto-picks input')];
+  $('auto-add').disabled = !picked.size;
+  $('auto-all').textContent = tr(boxes.length && boxes.every((b) => b.checked) ? 'Clear' : 'All projects');
+  $('auto-all').hidden = boxes.length < 2;
+}
+
+const BACK_WORDS = 'Each task that does not pass goes back to work by itself: write what is wrong with kb note <KEY>, then kb mv <KEY> todo.';
 async function addRule(btn) {
   const min = Number($('auto-min').value);
-  if (!picked) return;
-  if (!Number.isInteger(min) || min < 0 || min > 120) { styledAlert(tr('The pause is whole minutes, from 0 to 120.')); return; }
+  if (!picked.size) return;
+  if (!SCHEDULED.has(formKind) && (!Number.isInteger(min) || min < 0 || min > 120)) { styledAlert(tr('The pause is whole minutes, from 0 to 120.')); return; }
   btn.disabled = true;
-  try {
-    const v = await api('POST', '/api/automations', {
-      project: picked, delay_min: min, words: checkWords(),
-      launch: { permission: getSetting('permission'), effort: startEffort(true, getSetting('effort'), getSetting('effortCheck')) || undefined },
-    }, { quiet: true });
-    btn.disabled = false;
-    applyAutomations(v);
-  } catch (e) {
-    btn.disabled = false;
-    styledAlert(refusalLine('Could not add the automation', e, tr));
+  const check = formKind === CHECK_KIND;
+  const repeat = check && $('auto-repeat').checked;
+  const fix = repeat && $('auto-fix').checked;
+  const plan = { at: $('auto-at').value, day: formDay === 'every' ? null : Number(formDay) };
+  const launch = { permission: getSetting('permission'), effort: startEffort(formKind === 'schedule-check' || check, getSetting('effort'), getSetting('effortCheck')) || undefined };
+  const wordsFor = (project) => {
+    if (formKind === 'todo-queue') { const w = checkWords(); return { run: w.run, doTask: w.doTask }; }
+    if (formKind === 'schedule-groom') return { run: checkWords().run, groom: `${tr('Groom the backlog of')} ${project} ${tr('(grooming mode):')}` };
+    return { ...checkWords(), ...(fix ? { back: tr(BACK_WORDS) } : {}) };
+  };
+  const refused = [];
+  let last = null;
+  for (const project of [...picked]) {
+    try {
+      last = await api('POST', '/api/automations', {
+        project, kind: formKind, ...(SCHEDULED.has(formKind) ? { plan } : { delay_min: min }), ...(check ? { repeat, fix } : {}), words: wordsFor(project), launch,
+      }, { quiet: true });
+    } catch (e) { refused.push(`${projectName(project)}: ${refusalLine('Could not add the automation', e, tr)}`); }
   }
+  btn.disabled = !picked.size;
+  if (last) applyAutomations(last);
+  if (refused.length) styledAlert(refused.join('\n'));
 }
 async function dropRule(id, btn) {
   btn.disabled = true;

package/public/js/away-rules.js

@@ -0,0 +1,5 @@
+export const AWAY_MS = 8 * 3600_000; // the owner's word: eight hours of silence
+/** Whether a page seen last at `last` owes a summary at `now`. A first visit has nothing to tell. */
+export const awayDue = (last, now) => Number.isFinite(last) && last > 0 && now - last >= AWAY_MS;
+/** Whether a summary has anything to tell. */
+export const hasNews = (s) => ['handed', 'accepted', 'returned', 'stuck'].some((k) => s?.[k]?.n > 0);

package/public/js/away.js

@@ -0,0 +1,55 @@
+import { api, esc, tr } from './core.js';
+import { automations, loadAutomations } from './automations.js';
+import { openDrawer } from './drawer.js';
+import { plural } from './settings.js';
+import { overlayLayer } from './sidebar.js';
+import { localStore } from './store.js';
+import { awayDue, hasNews } from './away-rules.js';
+
+const SEEN_KEY = 'kb.ui.lastSeen';
+const SEEN_EVERY_MS = 60_000;
+const seenAt = () => { try { return Number(localStore.getItem(SEEN_KEY)); } catch { return 0; } };
+const noteSeen = () => { try { localStore.setItem(SEEN_KEY, String(Date.now())); } catch { /* not kept */ } };
+
+const SECTIONS = [['handed', 'Handed in'], ['accepted', 'Accepted'], ['returned', 'Returned'], ['stuck', 'Stuck']];
+function sectionHTML(k, name, s) {
+  if (!s?.n) return '';
+  const rows = s.tasks.map((t) => `<button type="button" class="away-row" data-key="${esc(t.key)}"><span class="away-key">${esc(t.key)}</span><span class="away-title">${esc(t.title)}</span><span class="away-proj">${esc(t.project)}</span></button>`).join('');
+  const more = s.n - s.tasks.length;
+  return `<div class="away-sec"><div class="away-h">${esc(tr(name))}: ${s.n}</div>${rows}${more > 0 ? `<div class="muted away-more">${tr('and more:')} ${more} ${esc(plural(more, 'task', 'tasks'))}</div>` : ''}</div>`;
+}
+function showSummary(s) {
+  const overlay = document.createElement('div');
+  overlay.className = 'modal-overlay';
+  overlay.innerHTML = `<div class="modal away-box" role="dialog" aria-label="${esc(tr('While you were away'))}"><div class="modal-title">${esc(tr('While you were away'))}</div>`
+    + `<div class="away-body">${SECTIONS.map(([k, name]) => sectionHTML(k, name, s[k])).join('')}</div>`
+    + `<div class="modal-actions"><button type="button" class="btn-primary modal-ok">${esc(tr('Got it'))}</button></div></div>`;
+  const close = overlayLayer(overlay);
+  document.body.appendChild(overlay);
+  overlay.querySelector('.modal-ok').onclick = close;
+  overlay.querySelectorAll('.away-row').forEach((b) => { b.onclick = () => { close(); openDrawer(b.dataset.key); }; });
+  overlay.querySelector('.modal-ok').focus();
+}
+
+let looking = false;
+async function look() {
+  if (looking || document.hidden) return;
+  const last = seenAt();
+  if (Date.now() - last < SEEN_EVERY_MS) return;
+  looking = true;
+  noteSeen();
+  try {
+    if (!awayDue(last, Date.now())) return;
+    await loadAutomations();
+    if (!automations().on) return;
+    const s = await api('GET', `/api/automations/summary?since=${Math.round(last)}`, undefined, { quiet: true });
+    if (hasNews(s)) showSummary(s);
+  } catch { try { localStore.setItem(SEEN_KEY, String(last)); } catch { /* not kept */ } /* asked again at the next touch */ } finally { looking = false; }
+}
+/** On start, on a return to the tab and on the person's first touch: a tab left on the screen overnight is no one there, so
+    the moment seen is the person's, not the page's. */
+export function startAway() {
+  look();
+  document.addEventListener('visibilitychange', look);
+  for (const e of ['pointerdown', 'keydown', 'wheel']) document.addEventListener(e, look, { passive: true, capture: true });
+}