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

package/CHANGELOG.md

@@ -8,6 +8,26 @@ version it goes out as and opens an empty one again. Released sections are histo
 
 ## [Unreleased]
 
+## [2.0.0-beta.4]
+
+### Added
+
+- Health: a CLAUDE.md past a norm has «Fix» — it opens the task to shrink the file, with the docs of Claude Code, and starts Claude on it at once; while a Claude works in the project's folder, or a task of the project is in work, the button says what holds it and starts nothing.
+
+### Fixed
+
+- `kb note` and `kb review` send their note with a key, so a retry after a lost answer finds the note already written instead of adding a second one.
+- **Wi-Fi: a guest no longer sees where the project's notes and deploy skill lie on the owner's disk.**
+- The commit line of a card no longer shows a foreign pull request with the same number or the newest commit of another task.
+- A card in Ready to ship says «waiting for you» when its Claude waits there for your word, with no second sound for it.
+- A Claude that got one of its helpers back and waits for the next no longer reads as waiting for you.
+- A group action or a drag the board refused says which tasks did not change and why, instead of putting cards back without a word; a refused title or description no longer holds the rest of the card's edit.
+- Automations: a rule waits for the board to read the terminals after a restart before it starts a check, a pause after a refused start outlives a restart, words that cannot reach Claude stop after three tries, a card says when the board could not tell Claude to go on, and a limit line wrapped in the middle of its time keeps am/pm.
+- Going on with interrupted work: tmux too slow to answer no longer uses up the tries of a session, and a card the board could not set going says what held it.
+- On a Mac the board starts git and its other programs by their full path: a bare name was a short-lived process for every folder of PATH in front of it, and their stream held the start of tmux for seconds. The tests of tmux no longer fail beside the test of the mark «on main», the suite runs in 55 s instead of 92, and a release runs it at once again.
+- The chat keeps words with pictures you sent while Claude worked: they vanished from it the moment Claude took them.
+- A terminal tmux is slow to answer about no longer reads as «Not running», nor its chat as «does not run inside the board»: the screen and its state stay until tmux answers.
+
 ## [2.0.0-beta.3]
 
 ### Fixed

package/bin/kb

@@ -4,6 +4,7 @@
 
 import { parsePm2Services } from '../src/pm2-services.js';
 import { closeSync, writeSync } from 'node:fs';
+import { createHash } from 'node:crypto';
 import { memoryText, moneyText, tokensText } from '../public/js/usage-rules.js';
 import { HOOK_WAIT_MS } from '../src/claude-hooks.js';
 
@@ -56,6 +57,8 @@ const TASK = ['a task', (d) => isObj(d) && typeof d.key === 'string' && typeof d
 const LIST = ['a list', Array.isArray];
 const PROJECT = ['a project', (d) => isObj(d) && typeof d.slug === 'string'];
 const COMMENT = ['a comment', (d) => isObj(d) && Number.isInteger(d.id)];
+// was on the card and someone deleted it there.
+const NOTE = ['a comment', (d) => COMMENT[1](d) || (isObj(d) && d.deleted === true)];
 const ITEM = ['a checklist item', (d) => isObj(d) && typeof d.text === 'string'];
 const DOCS = ['the project documents', (d) => isObj(d) && Array.isArray(d.docs)];
 const TAKEN = ['a taken task', (d) => isObj(d) && Number.isInteger(d.blocked_n) && (d.task === null || TASK[1](d.task))];
@@ -72,6 +75,17 @@ function key(id) {
   if (!KEY_RE.test(id)) die(`kb: "${id}" is not a task key (like CK-12) or a task id`);
   return encodeURIComponent(id);
 }
+// after the board wrote the note (code 1), and the retry is a new kb with nothing remembered — the same key lets
+// the board find what it already wrote instead of writing it twice. The same words from the same session again
+// stay one note; that repeats nothing a person would want twice.
+function noteKey(id, body) {
+  return 'kb-' + createHash('sha256').update(`${String(id).toUpperCase()}\n${SESSION}\n${body}`).digest('hex').slice(0, 40);
+}
+async function postNote(id, body) {
+  const c = await api('POST', `/api/tasks/${key(id)}/comments`, { body, author: 'claude', client_key: noteKey(id, body) }, NOTE);
+  if (c.deleted) die(`kb: the same note was on ${id} and was deleted there — not written again; change the words to add it`);
+  return c;
+}
 function seg(s) {
   if (s === '.' || s === '..') die(`kb: "${s}" is not a project`);
   return encodeURIComponent(s);
@@ -470,7 +484,7 @@ const commands = {
     const t = await api('PATCH', `/api/tasks/${key(id)}`, { status: 'review' }, TASK);
     const unsaved = (code) => { if (code) process.stderr.write(`kb: ${t.key} is in review, but the note did not save — kb note ${t.key} "…"\n`); };
     process.on('exit', unsaved);
-    await api('POST', `/api/tasks/${key(id)}/comments`, { body: note, author: 'claude' }, COMMENT);
+    await postNote(id, note);
     process.off('exit', unsaved);
     console.log(`${t.key} review 📝`);
   },
@@ -605,7 +619,7 @@ const commands = {
     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);
+    await postNote(id, body);
     console.log(`${id} 📝`);
   },
 

package/package.json

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

package/public/js/board.js

@@ -13,7 +13,7 @@ import { columnCheck, reviewGroups } from './review-rules.js';
 import { heldWhy, startCheckIn } from './review.js';
 import { autoSlot } from './automations.js';
 import { paintAttention } from './attention.js';
-import { refusalLine } from './unsaved.js';
+import { refusalLine, refusalText } from './unsaved.js';
 import { localStore } from './store.js';
 import { SHIP_TITLES, SHIP_WORDS, notOnMain, shipAsker, showsShip } from './shipped-rules.js';
 import { boardColumns } from './ready-rules.js';
@@ -586,10 +586,27 @@ function renderMultiPanel() {
     + `<button class="multi-clear" data-act="clear">${tr('Clear selection')}</button>`;
   box.querySelectorAll('[data-act]').forEach((b) => { b.onclick = () => multiAction(b.dataset.act, b); });
 }
-async function multiPatchEach(bodyFor) {
+export function refusedManyText(head, refused, t = tr) {
+  const by = new Map();
+  for (const { key, e } of refused) {
+    const why = t(refusalText(e).reason);
+    by.set(why, [...(by.get(why) || []), key]);
+  }
+  const keys = (ks) => (ks.length > 6 ? `${ks.slice(0, 6).join(', ')} +${ks.length - 6}` : ks.join(', '));
+  const lines = [...by].map(([why, ks]) => `${keys(ks)}: ${why}`);
+  return lines.length === 1 ? `${t(head)} — ${lines[0]}` : `${t(head)}:\n${lines.join('\n')}`;
+}
+function sayRefusedMany(head, refused) {
+  if (refused.length) styledAlert(refusedManyText(head, refused));
+}
+async function multiPatchEach(bodyFor, head = 'Not saved') {
   const tasks = selectedTaskList();
-  for (const t of tasks) { try { await api('PATCH', `/api/tasks/${seg(t.key)}`, bodyFor(t), { quiet: true }); } catch {  } }
+  const refused = [];
+  for (const t of tasks) {
+    try { await api('PATCH', `/api/tasks/${seg(t.key)}`, bodyFor(t), { quiet: true }); } catch (e) { refused.push({ key: t.key, e }); }
+  }
   await refresh();
+  sayRefusedMany(head, refused);
 }
 function renderMultiSub(title, optsHTML, onPick) {
   const box = $('drawer-multi');
@@ -608,7 +625,7 @@ export async function multiAction(act, btn) {
     }).join('');
     renderMultiSub(tr('Move to status'), opts, async (o) => {
       if (o.classList.contains('disabled')) return;
-      await multiPatchEach(() => ({ status: o.dataset.v }));
+      await multiPatchEach(() => ({ status: o.dataset.v }), 'Not moved');
       renderMultiPanel();
     });
     return;
@@ -779,7 +796,7 @@ const LIVE_BADGE = {
 function liveBadge(t) {
   if (hasAsk(t.id)) return `<span class="card-live live-wait live-ask" title="${esc(tr('Claude is waiting for your answer — open the card'))}"><span class="live-dot"></span>${tr('needs your answer')}</span>`;
   const l = state.live[t.id];
-  const b = l && WORKING.has(t.status) && LIVE_BADGE[l.claude === 'gone' && l.interrupted ? 'interrupted'
+  const b = l && (WORKING.has(t.status) || t.status === 'ready') && LIVE_BADGE[l.claude === 'gone' && l.interrupted ? 'interrupted'
     : l.claude === 'idle' && l.broke ? (l.broke === 'retrying' ? 'brokeRetrying' : 'brokeStuck') : l.claude];
   if (!b) return '';
   const until = l.claude === 'limit' && l.resets ? ` · ${tr('until')} ${esc(l.resets)}` : '';
@@ -938,10 +955,12 @@ async function onDrop(e, status, body) {
   }
   dropPh.remove();
   try {
-    await api('PATCH', `/api/tasks/${seg(id)}`, patch);
+    await api('PATCH', `/api/tasks/${seg(id)}`, patch, { quiet: true });
   } catch (e) {
     renderBoard();
-    if (e?.offline) noteUnsaved(() => api('PATCH', `/api/tasks/${seg(id)}`, patch).then(refresh));
+    if (e?.offline) { noteUnsaved(() => api('PATCH', `/api/tasks/${seg(id)}`, patch).then(refresh)); return; }
+    sayRefusedMany('Not moved', [{ key: t.key, e }]);
+    await refresh();
     return;
   }
   await refresh();
@@ -976,12 +995,15 @@ async function onDropGroup(e, status, body) {
 
   dropPh.remove();
   dropSends = true;
+  const failed = [];
   for (let i = 0; i < movable.length; i++) {
     if (fixedOrder && movable[i].status === status) continue;
-    await api('PATCH', `/api/tasks/${seg(movable[i].id)}`, fixedOrder ? { status } : { status, position: prev + step * (i + 1) });
+    try { await api('PATCH', `/api/tasks/${seg(movable[i].id)}`, fixedOrder ? { status } : { status, position: prev + step * (i + 1) }, { quiet: true }); }
+    catch (e) { failed.push({ key: movable[i].key, e }); }
   }
   clearSelection();
   await refresh();
+  sayRefusedMany('Not moved', failed);
 }
 
 export function buildSelect(host, opts) {

package/public/js/chat.js

@@ -125,10 +125,10 @@ const codeBtn = (what, icon, label) => `<button type="button" class="chat-code-b
 // a block left open (cut off, or its fence missing) is not a command to run: its end is not known; nor is one longer than
 const RUN_MAX = 8000;
 const codeTools = (lang, closed, code = '') => `<span class="chat-code-tools">${codeBtn('copy', 'copy', 'Copy')}${closed && SHELL_LANGS.includes(lang) && code.length <= RUN_MAX ? codeBtn('run', 'terminal', 'Run in a Terminal window') : ''}</span>`;
-function itemHTML(it) {
+function itemHTML(it, shot = null) {
   if (answered(it)) return answersHTML(it.answers);
   return it.kind === 'stop' ? `<div class="chat-sep">${esc(tr('Stopped'))}</div>`
-    : it.kind === 'said' ? `<div class="chat-user chat-mid"><div class="chat-bubble">${esc(it.text)}</div></div>`
+    : it.kind === 'said' ? wordsHTML(it.text, it.images, it.shots, shot, ' chat-mid')
       : `<div class="chat-claude">${chatText(it.text, codeTools)}</div>`;
 }
 const CODE_DONE_MS = 1400; // the ✓ a button shows after it did its work
@@ -204,11 +204,11 @@ function runHTML(steps, id, open, { working, now = null, pic = null }) {
     + `${failed ? `<span class="chat-x">✗ ${failed}</span>` : ''}${ic('chevron', 11)}${thumb}</button>`
     + (open ? `<div class="chat-unfold chat-runbox" data-of="${esc(id)}">${steps.map((s) => stepRow(s, working)).join('')}</div>` : '');
 }
-function itemsHTML(items, at, { opened, working, fold = true, live = false, pic = null }) {
+function itemsHTML(items, at, { opened, working, fold = true, live = false, pic = null, shot = null }) {
   let out = '';
   const runs = runsOf(items);
   runs.forEach((r, i) => {
-    if (r.it) { out += itemHTML(r.it); return; }
+    if (r.it) { out += itemHTML(r.it, shot); return; }
     if (!fold) { out += r.steps.map((s) => stepRow(s, working)).join(''); return; }
     const id = `${at}|${i}`;
     // Claude calls tools side by side: the one still unanswered may be any of the run's, not its last
@@ -265,28 +265,29 @@ export function carryOpened(turns, opened) {
 }
 const SHOT_W = 220; // a thumbnail of the person's picture at most (.chat-shot img)
 const SHOT_H = 160;
+function wordsHTML(text, images, shotList, shot, cls = '') {
+  const shots = shot && shotList?.length ? shotList : [];
+  // as many «[Image #N]» as pictures shown leave the words — the rest stay with the «📎» that counts them
+  let strip = shots.length;
+  const words = strip ? String(text || '').replace(/\[Image #\d+\]\s*/g, (x) => (strip-- > 0 ? '' : x)).trim() : text;
+  const unseen = (images || 0) - shots.length; // a picture the board cannot show is still counted
+  const pics = shots.length ? `<div class="chat-shots">${shots.map((x) => {
+    // the place is kept before the picture decodes: a thumbnail growing late pushed the turn being read
+    const k = x.w > 0 && x.h > 0 ? Math.min(1, SHOT_W / x.w, SHOT_H / x.h) : 0;
+    const size = k ? ` width="${Math.max(1, Math.round(x.w * k))}" height="${Math.max(1, Math.round(x.h * k))}"` : '';
+    return `<button type="button" class="chat-shot" data-shot="${esc(shot(x.ref))}" title="${esc(tr('Open the picture'))}"><img src="${esc(shot(x.ref))}" alt=""${size} decoding="async"></button>`;
+  }).join('')}</div>` : '';
+  const bubble = words || unseen > 0 ? `<div class="chat-bubble">${esc(words || '')}${unseen > 0 ? `<span class="chat-img">${ic('attach', 11)} ${unseen}</span>` : ''}</div>` : '';
+  return `<div class="chat-user${cls}${pics ? ' has-shots' : ''}">${pics}${bubble}</div>`;
+}
 export function turnHTML(t, { opened = new Set(), working = false, shot = null, pic = null, asking = false } = {}) {
   let out = '';
   if (t.compact) out += `<div class="chat-sep">${esc(tr('The conversation was compacted'))}</div>`;
-  if (t.user || t.images) {
-    const shots = shot && t.shots?.length ? t.shots : [];
-    // as many «[Image #N]» as pictures shown leave the words — the rest stay with the «📎» that counts them
-    let strip = shots.length;
-    const words = strip ? String(t.user || '').replace(/\[Image #\d+\]\s*/g, (x) => (strip-- > 0 ? '' : x)).trim() : t.user;
-    const unseen = (t.images || 0) - shots.length; // a picture the board cannot show is still counted
-    const pics = shots.length ? `<div class="chat-shots">${shots.map((x) => {
-      // the place is kept before the picture decodes: a thumbnail growing late pushed the turn being read
-      const k = x.w > 0 && x.h > 0 ? Math.min(1, SHOT_W / x.w, SHOT_H / x.h) : 0;
-      const size = k ? ` width="${Math.max(1, Math.round(x.w * k))}" height="${Math.max(1, Math.round(x.h * k))}"` : '';
-      return `<button type="button" class="chat-shot" data-shot="${esc(shot(x.ref))}" title="${esc(tr('Open the picture'))}"><img src="${esc(shot(x.ref))}" alt=""${size} decoding="async"></button>`;
-    }).join('')}</div>` : '';
-    const bubble = words || unseen > 0 ? `<div class="chat-bubble">${esc(words || '')}${unseen > 0 ? `<span class="chat-img">${ic('attach', 11)} ${unseen}</span>` : ''}</div>` : '';
-    out += `<div class="chat-user${pics ? ' has-shots' : ''}">${pics}${bubble}</div>`;
-  }
+  if (t.user || t.images) out += wordsHTML(t.user, t.images, t.shots, shot);
   const worked = t.ms ? `${esc(tr('Worked for'))} ${esc(dur(t.ms) || `${Math.round(t.ms / 1000)} ${tr('s')}`)}` : esc(tr('Done'));
   if (!barred(t)) {
     // a step waiting on a question or a permission is not run — Claude waits for the person (`asking`)
-    out += itemsHTML(t.items, t.at, { opened, working, live: working && Boolean(t.open) && !asking, pic });
+    out += itemsHTML(t.items, t.at, { opened, working, live: working && Boolean(t.open) && !asking, pic, shot });
     return `<div class="chat-turn" data-at="${esc(t.at)}">${out}</div>`;
   }
   // background) folded all its text behind the bar, and the words on the screen went at the end of the turn
@@ -303,11 +304,11 @@ export function turnHTML(t, { opened = new Set(), working = false, shot = null,
       .filter(Boolean).map((x) => `<span class="chat-chip">${x}</span>`).join('');
     out += `<button type="button" class="chat-done${open ? ' open' : ''}" data-fold="${esc(id)}" aria-expanded="${open}">${ic('chevron', 11)}${ic('check', 11)}<span class="chat-done-t">${worked}</span>`
       + `<span class="chat-chips">${failed ? `<span class="chat-chip chat-x">✗ ${failed}</span>` : ''}${chips}</span></button>`;
-    if (open) out += `<div class="chat-log-in chat-unfold" data-of="${esc(id)}">${itemsHTML(log, t.at, { opened, working, fold: false })}</div>`;
+    if (open) out += `<div class="chat-log-in chat-unfold" data-of="${esc(id)}">${itemsHTML(log, t.at, { opened, working, fold: false, shot })}</div>`;
   } else {
     out += `<div class="chat-worked">${ic('check', 11)} ${worked}</div>`;
   }
-  out += t.items.filter(said).map(itemHTML).join('');
+  out += t.items.filter(said).map((it) => itemHTML(it, shot)).join('');
   if (files.length) out += filesHTML(files, t.at, opened);
   if (last) out += itemHTML(last);
   return `<div class="chat-turn" data-at="${esc(t.at)}">${out}</div>`;

package/public/js/core.js

@@ -1479,6 +1479,15 @@ const I18N_RU = {
   'Not saved: only the owner of the board can do this.': 'Не сохранено: это может только владелец доски.',
   'only the owner of the board can do this': 'это может только владелец доски',
   'a guest starts Claude only inside the board': 'гость запускает Claude только внутри доски',
+  'tmux did not answer in time — try again in a few seconds': 'tmux не ответил вовремя — повтори через несколько секунд',
+  'the project has no CLAUDE.md of its own any more': 'у проекта больше нет своего CLAUDE.md',
+  'Fix': 'Починить',
+  'Open the task «Shrink CLAUDE.md» and start Claude on it — only while nobody works in the folder of the project': 'Завести задачу «Ужать CLAUDE.md» и сразу запустить на ней Claude — только пока в папке проекта никто не работает',
+  'Claude works in the folder of this project — fix its CLAUDE.md once that work is over.': 'В папке этого проекта сейчас работает Claude — почини его CLAUDE.md, когда эта работа закончится.',
+  'Tasks in work': 'Задачи в работе',
+  'Claude sessions at work there': 'Сессий Claude работает там',
+  'The last fix of this CLAUDE.md waits for your review': 'Прошлая починка этого CLAUDE.md ждёт твоей проверки',
+  'Could not open the task': 'Не удалось завести задачу',
   'this board has no such label': 'на этой доске такой метки нет',
   'Not saved: this device no longer has the key of the board, it may have been changed. Copy what you typed, then reload the page and enter the key.': 'Не сохранено: у этого устройства больше нет ключа доски, возможно, его сменили. Скопируй набранное, обнови страницу и введи ключ.',
   'this device no longer has the key of the board, it may have been changed — copy what you typed, then reload the page and enter the key': 'у этого устройства больше нет ключа доски, возможно, его сменили — скопируй набранное, обнови страницу и введи ключ',

package/public/js/drawer.js

@@ -601,6 +601,7 @@ async function pollTerminal() {
   let r;
   try { r = await api('GET', `/api/tasks/${seg(key)}/terminal${qs ? `?${qs}` : ''}`, undefined, { quiet: true }); } catch { return; }
   if (n !== termReq || key !== termKey || key !== state.drawerKey) return;
+  if (r.unknown) return;
   if (!r.same) {
     r = wholeAnswer(r, termBase, termSeen);
     if (!r) { termSeen = null; return; } // not against what this card has: the next look gets it whole

package/public/js/health.js

@@ -2,7 +2,10 @@
 import { $, HEALTH, LANG, api, esc, ic, state, tr } from './core.js';
 import { keepFocus } from './now.js';
 import { plural } from './settings.js';
-import { selectProject } from './sidebar.js';
+import { selectProject, styledAlert, styledConfirm } from './sidebar.js';
+import { refusalLine } from './unsaved.js';
+import { openDrawer } from './drawer.js';
+import { launchInClaude, taskPromptText } from './sse.js';
 import { fileState, healthCounts, healthGroups, startTotal } from './health-rules.js';
 
 const FRESH_MS = 30000;
@@ -48,13 +51,16 @@ function projectHTML(p, d) {
     : `<span class="hl-size muted">${esc(tr('no CLAUDE.md of its own'))}</span>`;
   const start = `<span class="hl-start${total.over ? ' hl-heavy' : ''}" title="${esc(tr('Everything a session reads when it starts in this folder, with your own files'))}">`
     + `${esc(tr('at the start'))}: ${esc(num(total.chars))} ${esc(plural(total.chars, 'character', 'characters'))}</span>`;
+  const fix = st === 'heavy' || st === 'long'
+    ? `<button type="button" class="btn-ghost hl-fix" data-slug="${esc(p.slug)}" title="${esc(tr('Open the task «Shrink CLAUDE.md» and start Claude on it — only while nobody works in the folder of the project'))}">${esc(tr('Fix'))}</button>`
+    : '';
   const files = [...p.files, ...p.nested];
   const body = files.length
     ? files.map((f) => fileHTML(f, norms)).join('')
     : `<div class="hl-file muted">${esc(tr('Claude Code reads nothing of this project at the start but your own files.'))}</div>`;
   return `<details class="hl-proj" data-slug="${esc(p.slug)}"${opened.has(p.slug) ? ' open' : ''}>`
     + `<summary class="hl-row">${ic('chevron', 13)}<span class="hl-main"><a class="hl-name" href="#" data-slug="${esc(p.slug)}">${esc(p.name)}</a>`
-    + `<span class="hl-what">${what}</span></span>${start}</summary>`
+    + `<span class="hl-what">${what}</span></span>${start}${fix}</summary>`
     + `<div class="hl-files">${body}</div></details>`;
 }
 
@@ -109,6 +115,39 @@ function paint(d) {
     a.onclick = (e) => { e.preventDefault(); e.stopPropagation(); selectProject(a.dataset.slug); };
   });
   box.querySelector('.hl-again').onclick = (e) => { e.currentTarget.disabled = true; renderHealth({ force: true }); };
+  box.querySelectorAll('.hl-fix').forEach((b) => {
+    b.onclick = (e) => { e.preventDefault(); e.stopPropagation(); fixProject(b.dataset.slug, b); }; // a click in <summary> folds it
+  });
+}
+
+const fixing = new Set(); // a second press while the first one opens and starts the task
+/** The words of a refusal «Claude works there»: what holds the folder. */
+export function busyWords(b) {
+  const parts = [tr('Claude works in the folder of this project — fix its CLAUDE.md once that work is over.')];
+  if (b.keys?.length) parts.push(`${tr('Tasks in work')}: ${b.keys.join(', ')}.`);
+  if (b.sessions) parts.push(`${tr('Claude sessions at work there')}: ${b.sessions}.`);
+  return parts.join(' ');
+}
+async function fixProject(slug, btn) {
+  if (!slug || fixing.has(slug)) return;
+  fixing.add(slug);
+  btn.disabled = true;
+  try {
+    let r;
+    try { r = await api('POST', '/api/health/fix', { project: slug }, { quiet: true }); } catch (e) {
+      const b = e.body || {};
+      if (b.reason === 'busy') styledAlert(busyWords(b));
+      else if (b.reason === 'review' && b.key) {
+        styledConfirm(`${tr('The last fix of this CLAUDE.md waits for your review')}: ${b.key}.`, { okLabel: `${tr('Open')} ${b.key}` })
+          .then((ok) => { if (ok) openDrawer(b.key); });
+      } else styledAlert(refusalLine('Could not open the task', e, tr));
+      return;
+    }
+    await launchInClaude({ text: taskPromptText(r.key), project: slug, keys: [r.key], btn });
+  } finally {
+    fixing.delete(slug);
+    btn.disabled = false;
+  }
 }
 
 let seq = 0;

package/public/js/now-terms.js

@@ -208,7 +208,7 @@ async function look(c) {
   let r;
   try { r = await api('GET', `/api/tasks/${seg(c.key)}/terminal?${q}`, undefined, { quiet: true }); } catch { return; }
   if (n2 !== c.req) return; // a newer look has answered already
-  if (r.same) return;
+  if (r.same || r.unknown) return;
   r = wholeAnswer(r, c.base, c.seen);
   if (!r) { c.seen = null; return; } // not against what this column has: the next look gets it whole
   c.seen = r.v || null;

package/public/js/project.js

@@ -227,7 +227,7 @@ async function renderDocs(p) {
   const row = (opts) => `<div class="ps-doc${opts.missing ? ' ps-doc-missing' : ''}">
       <span class="ps-doc-ic">${ic(opts.icon, 13)}</span>
       <span class="ps-doc-name">${esc(opts.title)}${opts.tag ? `<span class="ps-doc-tag">${esc(opts.tag)}</span>` : ''}</span>
-      <span class="ps-doc-path" title="${esc(opts.path || '')}">${esc(opts.path || tr('not there'))}</span>
+      <span class="ps-doc-path" title="${esc(opts.path || '')}">${esc(opts.path || (info.paths_hidden ? '' : tr('not there')))}</span>
       <span class="ps-doc-act">
         ${opts.missing ? '' : `<button class="btn-icon ps-doc-open" data-open="${esc(opts.open)}" title="${tr('Open')}">${ic('eye', 13)}</button>`}
         ${opts.path ? `<button class="btn-icon ps-doc-copy" data-copy="${esc(opts.path)}" title="${tr('Copy the path')}">${ic('copy', 13)}</button>` : ''}

package/public/js/review.js

@@ -147,7 +147,7 @@ export async function renderReview() {
   await Promise.all(groups.filter((g) => g.running).map(async (g) => {
     try {
       const t = await api('GET', `/api/tasks/${encodeURIComponent(g.running.key)}/terminal`, undefined, { quiet: true });
-      g.terminal = { session: t.session || null, dead: Boolean(t.dead), question: Boolean(t.question) };
+      if (!t.unknown) g.terminal = { session: t.session || null, dead: Boolean(t.dead), question: Boolean(t.question) };
     } catch { /* no answer: the column says what it can */ }
   }));
   if (state.slug !== REVIEW || my !== seq) return;

package/public/js/sse.js

@@ -257,7 +257,7 @@ function openTaskFromNotification(key, project) {
 function maybeWaitingAlert(changes) {
   // it tells its Claude to go on (`retrying`): that rang for a blink of the network the person need not see
   const waiting = (changes || []).filter((c) => (c.claude === 'idle' && c.broke === 'stuck' && c.fromBroke !== 'stuck')
-    || (!c.broke && (c.from === 'busy' || c.from === 'background') && (c.claude === 'waiting' || c.claude === 'idle'))
+    || (!c.broke && c.status !== 'ready' && (c.from === 'busy' || c.from === 'background') && (c.claude === 'waiting' || c.claude === 'idle'))
     || (c.claude === 'limit' && c.from !== 'limit'));
   if (!waiting.length) return new Set();
   playReviewSound();

package/public/js/unsaved.js

@@ -234,6 +234,8 @@ const KNOWN = [
   [/^the project has no folder on this computer — the command would run/, 'the project has no folder on this computer — set it in the project, or copy the command'],
   [/^the terminal did not open/, 'the terminal did not open — copy the command instead; the details are in Settings → Errors'],
   [/^a guest starts Claude inside the board only$/, 'a guest starts Claude only inside the board'],
+  [/^the project has no CLAUDE\.md of its own$/, 'the project has no CLAUDE.md of its own any more'],
+  [/^tmux did not answer in time — try again$/, 'tmux did not answer in time — try again in a few seconds'],
   [/^unknown labels: /, 'this board has no such label'],
 ];
 export function refusalText(e) {

package/public/style.css

@@ -1081,7 +1081,7 @@ html[data-design="v3"] .drawer.drawer-full { padding-inline: max(18px, calc((100
   box-shadow: 0 16px 48px rgba(0,0,0,.18); padding: 16px; width: 320px;
   display: flex; flex-direction: column; gap: 10px;
 }
-.modal-title { font-weight: 600; font-size: 14px; text-wrap: pretty; }
+.modal-title { font-weight: 600; font-size: 14px; text-wrap: pretty; white-space: pre-line; }
 .modal-input {
   padding: 8px 10px; border: 1px solid var(--border); border-radius: 8px;
   font: inherit; font-size: 13px; outline: none; background: var(--input-bg); color: var(--text);
@@ -2782,6 +2782,7 @@ a.hl-name:hover { color: var(--accent); }
 .hl-heavy, .hl-state.hl-heavy { color: var(--accent); }
 .hl-start { flex: none; font-size: 12px; color: var(--muted); font-variant-numeric: tabular-nums; white-space: nowrap; }
 .hl-start.hl-heavy { color: var(--accent); }
+.hl-fix { flex: none; font-size: 12px; padding: 3px 10px; }
 .hl-files { display: flex; flex-direction: column; gap: 6px; padding: 0 0 12px 23px; }
 .hl-file { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 1px 12px; font-size: 12px; line-height: 1.4; }
 .hl-file-path { font-family: ui-monospace, monospace; font-size: 11.5px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

package/src/auto-health.js

@@ -1,16 +1,22 @@
+import { realpath } from 'node:fs/promises';
+import { relative, isAbsolute } from 'node:path';
 import { PORT } from './config.js';
 import { db, kvGet, kvSet, logError, uiLang } from './db.js';
 import { NORMS, healthView } from './health.js';
+import { readRegistry, stateOf } from './claude-live.js';
+import { noclaudeFilter } from './task-shape.js';
 
 export const HEALTH_SWITCH = 'automations.health';
 const LAST_KEY = 'automations.health.last';
 export const HEALTH_EVERY_MS = 24 * 3600_000;
 const own = { host: `127.0.0.1:${PORT}` };
 const TITLES = { ru: 'Ужать CLAUDE.md', en: 'Shrink CLAUDE.md' };
+export const HEALTH_DOCS = 'https://code.claude.com/docs/en/memory';
 const fmt = (n) => n.toLocaleString('ru-RU');
 const WORDS = {
-  ru: (file, chars) => `${file}: ${fmt(chars)} знаков при норме ${fmt(NORMS.file_chars)}. Claude Code предупреждает об этом на старте и хуже следует таким инструкциям. Подробности разнести по правилам .claude/rules/<тема>.md с paths:, в файле оставить общее.\n\nЗадачу завела доска: раздел «Здоровье», автоматизация.`,
-  en: (file, chars) => `${file}: ${fmt(chars)} characters, the norm is ${fmt(NORMS.file_chars)}. Claude Code warns about it at the start and follows such instructions worse. Move the details to rules .claude/rules/<topic>.md with paths:, and keep what is common in the file.\n\nThe board opened this task: the Health section, an automation.`,
+  ru: (file, chars, lines, by = 'автоматизация') => `${file}: ${fmt(chars)} знаков и ${fmt(lines)} строк при норме ${fmt(NORMS.file_chars)} знаков и ${fmt(NORMS.lines)} строк. Claude Code предупреждает о большом файле на старте и хуже следует длинным инструкциям.\n\nОптимизировать по документации Claude Code: ${HEALTH_DOCS}\n- в файле оставить общее для любой работы в проекте;\n- подробности по темам — в правила .claude/rules/<тема>.md с paths: (грузятся, только когда Claude работает с этими файлами) или в CLAUDE.md подпапки;\n- @-импорты место не экономят: файл грузится вместе с CLAUDE.md;\n- устаревшее переписать, историю починок не копить — она в git log.\n\nЗадачу завела доска: раздел «Здоровье», ${by}.`,
+  en: (file, chars, lines, by = 'an automation') => `${file}: ${fmt(chars)} characters and ${fmt(lines)} lines, the norm is ${fmt(NORMS.file_chars)} characters and ${fmt(NORMS.lines)} lines. Claude Code warns about a large file at the start and follows long instructions worse.\n\nOptimize it by the docs of Claude Code: ${HEALTH_DOCS}\n- keep in the file what any work in the project needs;\n- the details of a topic go to rules .claude/rules/<topic>.md with paths: (they load only when Claude works with those files) or to the CLAUDE.md of a subfolder;\n- @-imports save no room: the file loads together with the CLAUDE.md;\n- rewrite what is out of date, keep no history of fixes — it is in git log.\n\nThe board opened this task: the Health section, ${by}.`,
+  button: { ru: 'кнопка «Починить»', en: 'the button «Fix»' }, // who opened it, for the words above
 };
 
 /** The projects whose own CLAUDE.md is past the norm. Pure. */
@@ -30,7 +36,59 @@ export async function tickHealth(app, now) {
     const id = projects.find((x) => x.slug === p.slug)?.id;
     if (!id || seen.get(id, TITLES.ru, TITLES.en)) continue;
     const res = await app.inject({ method: 'POST', url: '/api/tasks', headers: own,
-      payload: { project: p.slug, title: TITLES[lang], description: WORDS[lang](p.main.path, p.main.chars), status: 'backlog' } });
+      payload: { project: p.slug, title: TITLES[lang], description: WORDS[lang](p.main.path, p.main.chars, p.main.lines), status: 'backlog' } });
     if (res.statusCode >= 300) logError('server', 'automations', `health task of ${p.slug}: ${res.statusCode} ${res.body.slice(0, 200)}`);
   }
 }
+
+const WORK = ['prep', 'doing', 'ready', 'deploy'];
+const within = (folder, cwd) => {
+  const rel = relative(folder, cwd);
+  return rel === '' || (!rel.startsWith('..') && !isAbsolute(rel));
+};
+/** The sessions at work in `folder` among the registry's entries ({cwd, alive, status}): their count. Pure. */
+export function claudesAt(folder, entries) {
+  let n = 0;
+  for (const e of entries) if (e.cwd && within(folder, e.cwd) && !['gone', 'idle'].includes(stateOf(e))) n += 1;
+  return n;
+}
+const real = async (p) => { try { return await realpath(p); } catch { return p; } };
+
+/** What holds a fix of the project's CLAUDE.md now: {sessions, keys} — nothing held when both are empty. */
+export async function fixHolds(project, registry = readRegistry) {
+  const folder = await real(project.path);
+  const entries = await Promise.all([...(await registry()).values()].map(async (e) => ({ ...e, cwd: e.cwd ? await real(e.cwd) : null })));
+  const keys = db.prepare(`SELECT p.prefix || '-' || t.task_no AS key FROM tasks t JOIN projects p ON p.id = t.project_id
+    WHERE t.project_id = ? AND t.status IN (${WORK.map(() => '?').join(', ')}) AND ${noclaudeFilter('t.')} ORDER BY t.task_no`)
+    .all(project.id, ...WORK).map((r) => r.key);
+  return { sessions: claudesAt(folder, entries), keys };
+}
+
+/** The task of «Fix» for a project: one still open of the same title (backlog → To do), else a new one in To do.
+    {key, created} or {code, error, reason, …} of a refusal. */
+export async function healthFixTask(app, slug, registry) {
+  const p = db.prepare('SELECT id, slug, name, path, category, archived FROM projects WHERE slug = ?').get(String(slug || ''));
+  if (!p) return { code: 404, error: 'project not found' };
+  if (p.archived) return { code: 400, error: 'the project is archived' };
+  const view = await healthView([p]);
+  const h = view.projects[0];
+  if (!p.path || h.folder === null || h.missing) return { code: 409, reason: 'no-folder', error: 'the project has no folder on this computer — set it in the project' };
+  if (!h.main) return { code: 409, reason: 'no-claude-md', error: 'the project has no CLAUDE.md of its own' };
+  const held = await fixHolds(p, registry);
+  if (held.sessions || held.keys.length) return { code: 409, reason: 'busy', error: 'Claude works in the folder of this project — fix it once the work there is over', ...held };
+  const open = db.prepare(`SELECT p.prefix || '-' || t.task_no AS key, t.status FROM tasks t JOIN projects p ON p.id = t.project_id
+    WHERE t.project_id = ? AND t.title IN (?, ?) AND t.status NOT IN ('done', 'cancelled') ORDER BY t.id DESC LIMIT 1`).get(p.id, TITLES.ru, TITLES.en);
+  if (open?.status === 'review') return { code: 409, reason: 'review', key: open.key, error: 'the last fix of this CLAUDE.md waits for your review' };
+  if (open) {
+    if (open.status === 'backlog') {
+      const res = await app.inject({ method: 'PATCH', url: `/api/tasks/${encodeURIComponent(open.key)}`, headers: own, payload: { status: 'todo' } });
+      if (res.statusCode >= 300) return { code: res.statusCode, error: res.json?.().error || 'could not move the task to To do' };
+    }
+    return { key: open.key, created: false };
+  }
+  const lang = uiLang() === 'en' ? 'en' : 'ru';
+  const res = await app.inject({ method: 'POST', url: '/api/tasks', headers: own,
+    payload: { project: p.slug, title: TITLES[lang], description: WORDS[lang](h.main.path, h.main.chars, h.main.lines, WORDS.button[lang]), status: 'todo' } });
+  if (res.statusCode >= 300) return { code: res.statusCode, error: res.json().error || 'could not open the task' };
+  return { key: res.json().key, created: true };
+}