local-kanban 1.16.0 → 2.0.0-beta.1

package/CHANGELOG.md

@@ -8,6 +8,30 @@ version it goes out as and opens an empty one again. Released sections are histo
 
 ## [Unreleased]
 
+## [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
+inside the board, you talk to it in the card, watch every session side by side, and a fresh Claude checks the work. A
+beta goes to everyone, like a release: `npm install -g local-kanban` and the update button both bring it, and your
+data stays. To stay on the last 1.x, run `npm install -g local-kanban@1.16.0`.
+
+### Changed
+
+- **The README shows the board as it is now**, in the dark theme, with Claude moving cards in the first picture.
+- **Update checks understand betas.** A board on a beta is offered the next beta and the release it leads to; before,
+  both looked like the version it already had.
+
+- **The chat says what Claude is doing while nothing lands in the transcript.** A long script takes a minute or two to
+  write, and all that time the chat said only "Claude is working…". The light is green now and tells how long the
+  transcript has been silent and, for a Claude inside the board, whether it is thinking or writing and how many tokens
+  it wrote. A counter that stood still for a minute with nothing to wait on turns the light yellow: "no answer for 1 min".
+- **Steps tell writing from running.** A step and a folded run of steps say how long Claude took to write them and how
+  long they ran: "wrote for 1 min 31 s · ran for 19 s". Before, only the second number was shown, and a session of
+  minutes looked like commands of seconds.
+- **Health lists the rules with `paths:` too.** The rules of a project's `.claude/rules` that Claude Code loads only
+  when it works with their files are listed with the CLAUDE.md files of subfolders, with their size: past the
+  per-file limit Claude Code reads only the start of such a file.
+
 ## [1.16.0]
 
 ### Added

package/README.md

@@ -1,14 +1,99 @@
-# local-kanban
+<h1 align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><img src="public/icon-192.png" alt="local-kanban" width="72" valign="middle" /></a> local-kanban
+  <br>
+  The kanban board Claude Code works from
+</h1>
 
-[![tests](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml/badge.svg)](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml)
+<p align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=light" alt="Version on npm" /></picture></a>
+  <a href="https://github.com/lamaohub/local-kanban/releases/latest"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="Latest release" /></picture></a>
+  <a href="LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="License" /></picture></a>
+  <a href="#requirements"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=light" alt="Runs on macOS and Linux" /></picture></a>
+</p>
 
-A local kanban board built for working **in tandem with Claude Code**: the human plans and accepts tasks, Claude takes them from the queue, does the work and reports back — all through a token-efficient CLI called `kb`. Optionally mirrors everything to GitHub (issues + Projects v2).
+<h3 align="center"><a href="#install"><ins>Install</ins></a> &nbsp;·&nbsp; <a href="#how-you-use-it">How it works</a> &nbsp;·&nbsp; <a href="CHANGELOG.md">What's new</a> &nbsp;·&nbsp; <a href="README.ru.md">Русская версия</a></h3>
 
-Русская версия — [README.ru.md](README.ru.md).
+<p align="center">
+  <img width="960" src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/board.gif" alt="Claude moves cards across the board on its own: To do, Prep, Doing, Deploying, Review" />
+</p>
 
-![Board](docs/screenshot-board.png)
+You plan and accept the work, Claude takes it from the queue, does it and reports back. Everything lives in one SQLite file on your machine and is driven by `kb`, a CLI that costs Claude few tokens. GitHub is an optional mirror, and nothing leaves your computer until you turn it on.
 
-![Dashboard](docs/screenshot-dashboard.png)
+> [!NOTE]
+> **2.0 is in beta, and it is what `npm install -g local-kanban` gives you.** It has been in daily use on real projects. Your board updates in place and keeps its data; to stay on the last 1.x, run `npm install -g local-kanban@1.16.0`. Found something broken? [Open an issue](https://github.com/lamaohub/local-kanban/issues).
+
+## Quick start
+
+```bash
+npm install -g local-kanban
+local-kanban            # setup wizard: Enter-Enter-Enter is enough
+local-kanban start      # board at http://localhost:3100
+```
+
+Needs Node.js 22 or newer on macOS or Linux. Details are under [Install](#install).
+
+## Features
+
+<h3 align="center">▶️ Press play, Claude starts working</h3>
+
+<p align="center">One button on <b>To do</b> hands the column to Claude Code, right inside the board: no window opens and no prompt is pasted. Claude takes each task, moves its card as it goes, commits, deploys if the project has a deploy skill, and stops at <b>Review</b>. Done is always&nbsp;your&nbsp;word.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-now.png" alt="Three Claude sessions working side by side in Claude now, each with its chat" width="100%" /></p>
+
+<br/>
+<h3 align="center">💬 Talk to Claude from&nbsp;the&nbsp;card</h3>
+
+<p align="center">Every task keeps its own chat: what Claude said, its steps folded, the files it changed, and how long it has been silent. Answer its questions and permissions there, send pictures, queue your next words while it works, or switch to its&nbsp;terminal.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/card-chat.png" alt="A task card with the chat of its Claude: the steps, the changed files and a field to answer in" width="100%" /></p>
+
+<br/>
+<h3 align="center">🔎 A fresh Claude checks&nbsp;the&nbsp;work</h3>
+
+<p align="center">Let <b>Review</b> pile up, then press one button. <b>Claude review</b> makes a check task and starts a Claude that did not write the code: it tests every task, tries to break it, moves what survives to Done and leaves a report. <b>Automations</b> can start it the moment a&nbsp;project&nbsp;goes&nbsp;quiet.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-review.png" alt="Claude review lists the tasks waiting in Review by project, with a Check in Claude button" width="88%" /></p>
+
+<br/>
+<h3 align="center">📊 A dashboard that&nbsp;tells&nbsp;the&nbsp;truth</h3>
+
+<p align="center">Work time counts only while Claude actually works, and stops when its session closes. See what waits for you, streaks, cycle time, when work happens and what Claude&nbsp;cost&nbsp;you.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/dashboard.png" alt="The dashboard: tasks waiting for you, week totals and activity charts" width="88%" /></p>
+
+<br/>
+<h3 align="center">📱 Your board on&nbsp;your&nbsp;phone</h3>
+
+<p align="center"><b>Settings → Wi-Fi</b> shows a QR code. Scan it and the board, the chats and Claude are in your hand, over your own network, with no account and no cloud. Install it as an app, or switch&nbsp;the&nbsp;door&nbsp;off&nbsp;again.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/phone.png" alt="The board and a task chat on a phone" width="70%" /></p>
+
+<br/>
+<h3 align="center">🩺 Keep Claude's instructions&nbsp;healthy</h3>
+
+<p align="center">Switch on <b>Settings → Health</b> and the board measures every CLAUDE.md against the norms of Claude Code and shows which projects load more than Claude will follow, and what to&nbsp;move&nbsp;into&nbsp;rules.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/health.png" alt="Health lists each project with the size of its CLAUDE.md and the norm it breaks" width="88%" /></p>
+
+<br/>
+<h3 align="center">🔌 Connected in&nbsp;one&nbsp;click</h3>
+
+<p align="center"><b>Settings → Claude Code</b> shows what the board needs and writes it after showing you exactly what will change: the status line for your rate limits, the hook for answers from the card, the skill that teaches Claude&nbsp;the&nbsp;workflow.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/setup.png" alt="Settings for Claude Code: what shows on the board, how Claude starts and what it may do" width="88%" /></p>
+
+<br/>
+### Also in the box
+
+- **Rate limits in the sidebar**: the 5-hour and weekly limits of your subscription, and what each task spent in tokens.
+- **GitHub mirror**: every task an issue, every project a GitHub Project, one way and in the background. Off until you set it.
+- **Backups**: a daily copy, a copy before every migration, and any of them opens as a second board next to the live one.
+- **Manual tasks**: the `noclaude` label keeps your own work out of Claude's metrics, and Claude never takes it.
+- **Linked tasks, subtasks, checklists, pictures in comments, search, hotkeys**, all readable by Claude through `kb`.
+- **English and Russian**, following your system language.
+- **An HTTP API and an event stream** for your own bots and stats: [docs/API.md](docs/API.md).
+
+---
 
 ## How you use it
 
@@ -232,7 +317,7 @@ Your data is never touched by updates: `data/` is gitignored and schema migratio
 
 **Rollback:** stop the server, restore the latest file from `data/backups/` (daily) or `data/backups/pre-migrate/` over `data/kanban.db`, then `git checkout <previous tag>` and start again.
 
-Releases live in `main` (stable, tagged); day-to-day development happens in `dev`.
+Releases live in `main` (tagged); day-to-day development happens in `dev`. A beta goes out the same way as a release, so `latest` and the update button bring it too. To go back: `npm install -g local-kanban@1.16.0`.
 
 ## Removing the board
 

package/README.ru.md

@@ -1,14 +1,99 @@
-# local-kanban
+<h1 align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><img src="public/icon-192.png" alt="local-kanban" width="72" valign="middle" /></a> local-kanban
+  <br>
+  Канбан-доска, с которой работает Claude Code
+</h1>
 
-[![tests](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml/badge.svg)](https://github.com/lamaohub/local-kanban/actions/workflows/test.yml)
+<p align="center">
+  <a href="https://www.npmjs.com/package/local-kanban"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/npm/local-kanban.svg?variant=secondary&mode=light" alt="Версия в npm" /></picture></a>
+  <a href="https://github.com/lamaohub/local-kanban/releases/latest"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/release/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="Последний релиз" /></picture></a>
+  <a href="LICENSE"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/github/license/lamaohub/local-kanban.svg?variant=secondary&mode=light" alt="Лицензия" /></picture></a>
+  <a href="#требования"><picture><source media="(prefers-color-scheme: dark)" srcset="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=dark" /><img src="https://shieldcn.dev/badge/platforms-macOS%20%C2%B7%20Linux.svg?variant=secondary&mode=light" alt="Работает на macOS и Linux" /></picture></a>
+</p>
 
-Локальная канбан-доска для работы **в паре с Claude Code**: человек планирует и принимает задачи, Claude берёт их из очереди, делает и отчитывается — через токен-экономный CLI `kb`. Опционально зеркалит всё в GitHub (issues + Projects v2).
+<h3 align="center"><a href="#установка"><ins>Установить</ins></a> &nbsp;·&nbsp; <a href="#как-этим-пользоваться">Как это работает</a> &nbsp;·&nbsp; <a href="CHANGELOG.md">Что нового</a> &nbsp;·&nbsp; <a href="README.md">English</a></h3>
 
-English version — [README.md](README.md).
+<p align="center">
+  <img width="960" src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/board.gif" alt="Claude сам двигает карточки по доске: Сделать, Подготовка, Делаю, Выкатываю, Проверяю" />
+</p>
 
-![Доска](docs/screenshot-board.png)
+Вы планируете и принимаете работу, Claude берёт её из очереди, делает и отчитывается. Всё лежит в одном файле SQLite на вашем компьютере и управляется через `kb` — CLI, который тратит мало токенов Claude. GitHub — необязательное зеркало: пока вы его не включите, ничего с компьютера не уходит.
 
-![Дашборд](docs/screenshot-dashboard.png)
+> [!NOTE]
+> **2.0 в бете, и именно её ставит `npm install -g local-kanban`.** Она каждый день работает на настоящих проектах. Доска обновляется на месте и сохраняет данные; остаться на последней 1.x — `npm install -g local-kanban@1.16.0`. Что-то сломалось? [Заведите issue](https://github.com/lamaohub/local-kanban/issues).
+
+## Быстрый старт
+
+```bash
+npm install -g local-kanban
+local-kanban            # мастер настройки: хватит Enter-Enter-Enter
+local-kanban start      # доска на http://localhost:3100
+```
+
+Нужен Node.js 22 или новее на macOS или Linux. Подробности — в разделе [Установка](#установка).
+
+## Возможности
+
+<h3 align="center">▶️ Нажали play — Claude работает</h3>
+
+<p align="center">Одна кнопка на колонке <b>Сделать</b> отдаёт её Claude Code прямо внутри доски: окна не открываются, промпт вставлять не нужно. Claude берёт каждую задачу, сам двигает карточку, коммитит, выкатывает, если у проекта есть скилл деплоя, и останавливается на <b>Проверяю</b>. Готово — всегда&nbsp;ваше&nbsp;слово.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-now.png" alt="Три сессии Claude работают рядом в разделе Claude now, у каждой свой чат" width="100%" /></p>
+
+<br/>
+<h3 align="center">💬 Разговор с Claude прямо&nbsp;в&nbsp;карточке</h3>
+
+<p align="center">У каждой задачи свой чат: что сказал Claude, свёрнутые шаги, изменённые файлы и сколько он уже молчит. Там же можно ответить на вопросы и разрешения, отправить картинку, поставить следующие слова в очередь, пока он работает, или открыть&nbsp;его&nbsp;терминал.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/card-chat.png" alt="Карточка задачи с чатом Claude: шаги, изменённые файлы и поле ответа" width="100%" /></p>
+
+<br/>
+<h3 align="center">🔎 Работу проверяет свежий&nbsp;Claude</h3>
+
+<p align="center">Дайте колонке <b>Проверяю</b> накопиться и нажмите одну кнопку. <b>Claude review</b> заводит задачу-проверку и запускает Claude, который этот код не писал: он тестирует каждую задачу, пробует её сломать, выжившее переводит в Готово и оставляет отчёт. <b>Автоматизации</b> запускают это сами, когда&nbsp;проект&nbsp;затих.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/claude-review.png" alt="Claude review показывает задачи в проверке по проектам и кнопку Check in Claude" width="88%" /></p>
+
+<br/>
+<h3 align="center">📊 Дашборд, которому&nbsp;можно&nbsp;верить</h3>
+
+<p align="center">Время работы считается, только пока Claude действительно работает, и стоит, когда сессия закрыта. Видно, что ждёт вас, серии, цикл задачи, когда идёт работа и сколько&nbsp;стоил&nbsp;Claude.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/dashboard.png" alt="Дашборд: что ждёт вас, итоги недели и графики активности" width="88%" /></p>
+
+<br/>
+<h3 align="center">📱 Доска у вас&nbsp;в&nbsp;телефоне</h3>
+
+<p align="center"><b>Настройки → Wi-Fi</b> показывают QR-код. Отсканируйте его, и доска, чаты и Claude у вас в руке — по вашей сети, без аккаунтов и облака. Можно поставить как приложение, а дверь&nbsp;в&nbsp;любой&nbsp;момент&nbsp;закрыть.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/phone.png" alt="Доска и чат задачи на телефоне" width="70%" /></p>
+
+<br/>
+<h3 align="center">🩺 Здоровье инструкций&nbsp;Claude</h3>
+
+<p align="center">Включите <b>Настройки → Здоровье</b>, и доска сверит каждый CLAUDE.md с нормами Claude Code и покажет, в каких проектах инструкций больше, чем Claude выполнит, и что вынести&nbsp;в&nbsp;правила.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/health.png" alt="Здоровье: проекты с размером CLAUDE.md и нарушенной нормой" width="88%" /></p>
+
+<br/>
+<h3 align="center">🔌 Подключение в&nbsp;один&nbsp;клик</h3>
+
+<p align="center"><b>Настройки → Claude Code</b> показывают, чего доске не хватает, и записывают это, сперва показав, что именно изменится: строку состояния для лимитов, хук для ответов из карточки, скилл с рабочим&nbsp;циклом&nbsp;для&nbsp;Claude.</p>
+
+<p align="center"><img src="https://raw.githubusercontent.com/lamaohub/local-kanban/main/docs/readme/setup.png" alt="Настройки Claude Code: что показывать на доске, как запускать Claude и что ему можно" width="88%" /></p>
+
+<br/>
+### И ещё
+
+- **Лимиты в сайдбаре**: пятичасовой и недельный лимиты подписки и расход токенов по каждой задаче.
+- **Зеркало на GitHub**: задача — issue, проект — GitHub Project, в одну сторону и в фоне. Выключено, пока не настроите.
+- **Бэкапы**: копия каждый день, копия перед каждой миграцией, и любую можно открыть второй доской рядом с живой.
+- **Ручные задачи**: метка `noclaude` не пускает вашу работу в метрики Claude, и Claude такую задачу не возьмёт.
+- **Связи, подзадачи, чек-листы, картинки в комментариях, поиск, горячие клавиши** — и всё это Claude читает через `kb`.
+- **Русский и английский** — по языку системы.
+- **HTTP API и поток событий** для своих ботов и статистики: [docs/API.md](docs/API.md).
+
+---
 
 ## Как этим пользоваться
 
@@ -216,7 +301,7 @@ npm run update   # git pull + npm install + pm2 restart (если примени
 
 **Откат:** останови сервер, восстанови свежий файл из `data/backups/` (суточные) или `data/backups/pre-migrate/` поверх `data/kanban.db`, затем `git checkout <предыдущий тег>` и запусти снова.
 
-Релизы живут в `main` (стабильное, с тегами); ежедневная разработка — в `dev`.
+Релизы живут в `main` (с тегами); ежедневная разработка — в `dev`. Бета выходит так же, как релиз, поэтому `latest` и кнопка обновления приносят и её. Вернуться назад: `npm install -g local-kanban@1.16.0`.
 
 ## Как убрать доску
 

package/package.json

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

package/public/js/chat.js

@@ -1,6 +1,6 @@
 
 import { api, esc, ic, seg, tr } from './core.js';
-import { SHORT_MONTHS, copyText, resumeOnBoard } from './sse.js';
+import { SHORT_MONTHS, copyText, resumeOnBoard, usageFmt } from './sse.js';
 import { matchKey, plural, setClaudeView } from './settings.js';
 import { refusalLine } from './unsaved.js';
 import { drawerIsFull, openDrawerFull, openLightbox, setDrawerFull, uploadAttachment } from './drawer.js';
@@ -10,6 +10,8 @@ import { buildSelect } from './board.js';
 import { SHELL_LANGS, chatText } from './chat-md.js';
 import { askBlock, isSending, plainLabel, questionAsk, renderAsks } from './asks.js';
 import { intoField, leftoverWords } from './ask-rules.js';
+import { paceStep, paceWords, stalled } from './pace-rules.js';
+import { tokensPhrase } from './usage-rules.js';
 
 const TURNS_STEP = 15;
 const STEP_KIND = {
@@ -81,7 +83,7 @@ function clockOf(iso) {
 }
 
 function stepRow(it, working = false) {
-  const tail = it.running ? '' : [dur(it.ms), it.error ? '' : (it.ms !== undefined ? '✓' : '')].filter(Boolean).join(' ');
+  const tail = it.running ? '' : [it.wrote ? timesWords(it.wrote, it.ms) : dur(it.ms), it.error ? '' : (it.ms !== undefined ? '✓' : '')].filter(Boolean).join(' ');
   const steps = it.helper ? `<span class="chat-step-n">${it.helper.steps} ${esc(plural(it.helper.steps, 'step', 'steps'))}</span>` : '';
   const since = it.running ? clockOf(it.at) : '';
   const bg = it.running ? `<span class="chat-bg">${working ? '<span class="chat-pulse"></span>' : ''}${esc(since ? `${tr('in the background since')} ${since}` : tr('in the background'))}</span>` : '';
@@ -89,7 +91,7 @@ function stepRow(it, working = false) {
     : `<span class="chat-step-t">${esc(it.text)}</span>`;
   return `<div class="chat-step${it.error ? ' err' : ''}${it.running ? ' running' : ''}" title="${esc(it.text)}"><span class="chat-step-k">${esc(tr(STEP_KIND[it.tool] || 'Tool'))}</span>`
     + what
-    + `<span class="chat-step-d">${steps}${bg}${it.error ? `<span class="chat-x" title="${esc(tr('failed'))}">✗</span>` : ''}${esc(tail)}</span></div>`
+    + `<span class="chat-step-d"${it.wrote ? ` title="${esc(tr(TIMES_TITLE))}"` : ''}>${steps}${bg}${it.error ? `<span class="chat-x" title="${esc(tr('failed'))}">✗</span>` : ''}${esc(tail)}</span></div>`
     + (it.helper?.now ? `<div class="chat-answer chat-now">↳ ${esc(tr(STEP_KIND[it.helper.now.tool] || 'Tool'))} · ${esc(it.helper.now.text)}</div>` : '')
     + (it.answer ? `<div class="chat-answer">↳ ${esc(it.answer)}</div>` : '');
 }
@@ -174,6 +176,9 @@ export function sinceWords(iso, now = Date.now()) {
   if (s < 60) return `${s} ${tr('s')}`;
   return s < 3600 ? `${Math.floor(s / 60)} ${tr('min')} ${s % 60} ${tr('s')}` : `${Math.floor(s / 3600)} ${tr('h')} ${Math.floor(s / 60) % 60} ${tr('min')}`;
 }
+const TIMES_TITLE = 'How long Claude thought and wrote this, and how long it ran';
+const RUN_TIMES_MIN_MS = 10000; // a run written in moments says nothing of it: the line stays short
+const timesWords = (wrote, ran) => [`${tr('wrote for')} ${sinceWords(0, wrote)}`, ran >= 1000 ? `${tr('ran for')} ${sinceWords(0, ran)}` : ''].filter(Boolean).join(' · ');
 const baseName = (f) => String(f).slice(String(f).lastIndexOf('/') + 1);
 function runHTML(steps, id, open, { working, now = null, pic = null }) {
   const failed = steps.filter((s) => s.error).length;
@@ -191,7 +196,10 @@ function runHTML(steps, id, open, { working, now = null, pic = null }) {
   // a picture Claude read shows at the line's end, as in the app, and opens whole on a click (not the fold: `data-pic`)
   const seen = pic && steps.findLast((s) => s.pic);
   const thumb = seen ? `<img class="chat-run-pic" data-pic="${esc(seen.pic)}" src="${esc(pic(seen.pic))}" alt="" title="${esc(tr('Open the picture'))}" loading="lazy" decoding="async">` : '';
-  return `<button type="button" class="chat-run${open ? ' open' : ''}${now ? ' now' : ''}" data-fold="${esc(id)}" aria-expanded="${open}">${head}`
+  const wrote = steps.reduce((x, s) => x + (s.wrote || 0), 0);
+  const ran = steps.reduce((x, s) => x + (s.running ? 0 : s.ms || 0), 0);
+  const times = !now && wrote >= RUN_TIMES_MIN_MS ? `<span class="chat-run-times" title="${esc(tr(TIMES_TITLE))}">${esc(timesWords(wrote, ran))}</span>` : '';
+  return `<button type="button" class="chat-run${open ? ' open' : ''}${now ? ' now' : ''}" data-fold="${esc(id)}" aria-expanded="${open}">${head}${times}`
     + `${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>` : '');
 }
@@ -311,24 +319,38 @@ const AWAY_LOOK_MS = 5000; // a transcript not written yet (a Claude just starte
 const LIT_LOOK_MS = 5000;
 const SENT_LOOK_MS = 1500;
 
-export function workingLine(d) {
+/** A step of the turn going on with no answer yet, or a helper at work: what Claude waits on — it writes nothing then. */
+const stepInHand = (d) => {
+  const turn = d.turns?.at(-1);
+  return Boolean(turn?.open && turn.items.some((it) => it.kind === 'tool' && it.ms === undefined && !it.running)) || running(d.turns).helpers > 0;
+};
+/** The moment the last line of a turn tells of: the transcript is silent from there on. 0 when there is none. */
+function lastMoment(turn) {
+  const moments = [new Date(turn.at).getTime(), ...turn.items.map((it) => new Date(it.at).getTime() + (it.ms || 0))];
+  return Math.max(...moments.filter(Number.isFinite), 0);
+}
+
+export function workingLine(d, stuckSince = 0) {
   if (!(d.working || (d.send && d.state === 'busy'))) return '';
   const { helpers, commands } = running(d.turns);
   const turn = d.turns?.at(-1);
   const turnOn = Boolean(turn?.open);
   // the card's head) — it waits for the person; «Claude works» there had the owner ask it, and it said nothing ran
   const left = !turnOn && d.turns?.length && !helpers && commands && d.own === false;
-  const words = tr(turnOn || !d.turns?.length ? 'Claude is working…' : left ? 'Waits for you · commands in the background' : 'Claude works in the background…')
+  const atWork = d.pace && !stuckSince ? paceWords(d.pace, stepInHand(d)) : 'Claude is working…';
+  const words = tr(turnOn || !d.turns?.length ? atWork : left ? 'Waits for you · commands in the background' : 'Claude works in the background…')
     + (helpers ? ` · ${tr('helpers at work:')} ${helpers}` : '');
   // a step with no answer yet, not one handed to the background — the one Claude waits on now
   const now = turnOn ? turn.items.at(-1) : null;
   const step = now?.kind === 'tool' && now.ms === undefined && !now.running
     ? `<span class="chat-working-now" title="${esc(now.text)}">${esc(tr(STEP_KIND[now.tool] || 'Tool'))} · ${esc(now.text)}</span>` : '';
-  return `<div class="chat-working"><span class="chat-pulse"></span><span class="chat-working-t">${esc(words)}</span>${step}</div>`;
+  const since = stuckSince || (turnOn ? lastMoment(turn) : 0);
+  const meter = since ? `<span class="chat-working-m">${stuckSince ? `${esc(tr('no answer for'))} ` : ''}<span class="chat-run-time" data-since="${esc(new Date(since).toISOString())}"></span><span class="chat-working-n"></span></span>` : '';
+  return `<div class="chat-working${stuckSince ? ' stalled' : ''}"><span class="chat-pulse"></span><span class="chat-working-t">${esc(words)}</span>${meter}${step}</div>`;
 }
 
-export function liveHTML(d) {
-  const lit = workingLine(d);
+export function liveHTML(d, stuckSince = 0) {
+  const lit = workingLine(d, stuckSince);
   if (!lit) return '';
   const going = (d.turns || []).flatMap((t) => t.items.filter((it) => it.kind === 'tool' && it.running));
   return `${going.length ? `<div class="chat-going">${going.map((it) => stepRow(it, true)).join('')}</div>` : ''}${lit}`;
@@ -552,6 +574,23 @@ export function mountChat(box, { key = null, session = null, scroller = null, fu
     };
   };
 
+  function liveNow(d) {
+    if (!d.pace) { c.paceMark = null; return liveHTML(d); }
+    const at = Date.now();
+    c.paceMark = paceStep(c.paceMark, JSON.stringify([d.session, d.pace, d.turns?.at(-1)?.items.length]), at);
+    return liveHTML(d, stalled(d.pace, stepInHand(d), c.paceMark, at) ? c.paceMark.at : 0);
+  }
+  function showLive(lit, d) {
+    // drawn only when it changed: the pulse would start anew on every look, five seconds apart
+    if (liveEl.dataset.html !== lit) { liveEl.dataset.html = lit; liveEl.innerHTML = lit; }
+    const count = liveEl.querySelector?.('.chat-working-n');
+    if (!count) return;
+    // a count that stopped says nothing new, and a narrow column has no room for it beside the words of a silent Claude
+    count.textContent = d.pace?.tokens && !liveEl.querySelector('.stalled') ? ` · ${tokensPhrase(d.pace.tokens, usageFmt)}` : '';
+    tickRuns();
+    if (!runClock) runClock = setInterval(tickRuns, 1000);
+  }
+
   function paint() {
     notePlace();
     const d = c.data;
@@ -590,7 +629,7 @@ export function mountChat(box, { key = null, session = null, scroller = null, fu
     const keepFrom = sc.scrollHeight - sc.scrollTop;
     const keepTop = sc.scrollTop;
     const anchor = atEnd ? null : seenTurn();
-    const lit = liveHTML(d);
+    const lit = liveNow(d);
     const sending = sentHTML(d);
     if (!d.session) {
       log.innerHTML = `<div class="chat-empty muted">${esc(tr('Claude has not worked on this task yet'))}</div>`;
@@ -609,8 +648,7 @@ export function mountChat(box, { key = null, session = null, scroller = null, fu
           pic: (id) => `/api/tasks/${seg(c.key)}/chat/picture/${seg(id)}?session=${encodeURIComponent(c.session)}` })).join('')
         + sending;
     }
-    // drawn only when it changed: the pulse would start anew on every look, five seconds apart
-    if (liveEl.dataset.html !== lit) { liveEl.dataset.html = lit; liveEl.innerHTML = lit; }
+    showLive(lit, d);
     if (!runClock && log.querySelector('.chat-run-time')) runClock = setInterval(tickRuns, 1000);
     // stopped (Esc) or ended its turn rings no event once its last line is written: the light stayed on for good
     clearTimeout(c.helperTimer);
@@ -916,6 +954,8 @@ export function mountChat(box, { key = null, session = null, scroller = null, fu
     if (key !== c.key || !mounted.has(c)) return; // another task meanwhile, or gone
     c.shownAsked = asked; // what the chat on screen was asked for: a pick that fails goes back to it
     if (r.same) {
+      c.data.pace = r.pace;
+      showLive(liveNow(c.data), c.data);
       if (workingLine(c.data)) { clearTimeout(c.helperTimer); c.helperTimer = setTimeout(refresh, LIT_LOOK_MS); }
       return;
     }

package/public/js/core.js

@@ -973,6 +973,7 @@ const I18N_RU = {
   'a rule without paths': 'правило без paths',
   'auto memory — the part that loads': 'автопамять — та часть, что грузится',
   'yours, in every project': 'твой, в каждом проекте',
+  'a rule with paths: — loads when Claude works with its files': 'правило с paths: — грузится, когда Claude работает с его файлами',
   'loads when Claude works in that folder': 'грузится, когда Claude работает в этой папке',
   'over 4 MB — Claude Code skips it': 'больше 4 МБ — Claude Code его пропускает',
   'no CLAUDE.md of its own': 'своего CLAUDE.md нет',
@@ -1638,6 +1639,12 @@ const I18N_RU = {
   'Claude has not worked on this task yet': 'Claude ещё не работал над этой задачей',
   'No messages yet': 'Сообщений пока нет',
   'Claude is working…': 'Claude работает…',
+  'Claude is thinking…': 'Claude думает…',
+  'Claude is writing…': 'Claude пишет…',
+  'no answer for': 'нет ответа уже',
+  'wrote for': 'писал',
+  'ran for': 'выполнял',
+  'How long Claude thought and wrote this, and how long it ran': 'Сколько Claude думал и писал это и сколько оно выполнялось',
   'Claude works in the background…': 'Claude работает в фоне…',
   'helpers at work:': 'помощников в работе:',
   'in the background': 'в фоне',

package/public/js/health.js

@@ -28,6 +28,7 @@ function kindWord(f) {
   return tr({
     main: 'the project\'s own', parent: 'from a folder above', local: 'personal, CLAUDE.local.md', rule: 'a rule without paths',
     memory: 'auto memory — the part that loads', user: 'yours, in every project', nested: 'loads when Claude works in that folder',
+    scoped: 'a rule with paths: — loads when Claude works with its files',
   }[f.kind] || f.kind);
 }
 function fileHTML(f, norms) {

package/public/js/pace-rules.js

@@ -0,0 +1,18 @@
+
+/** How long nothing may change before the light says there is no answer. */
+export const STALL_MS = 60_000;
+
+/** The light's words. `inHand` — a step or a helper Claude waits on: the counter stands still by right then. */
+export function paceWords(pace, inHand) {
+  if (inHand || !pace || pace.compacting) return 'Claude is working…';
+  if (pace.thinking) return 'Claude is thinking…';
+  return pace.tokens ? 'Claude is writing…' : 'Claude is working…';
+}
+
+/** The moment the spinner last said something new: `mark` is kept while `sig` — what it says now — stays the same. */
+export const paceStep = (mark, sig, now) => (mark?.sig === sig ? mark : { sig, at: now });
+
+/** Whether Claude stopped answering: its counter stood still for STALL_MS with nothing to wait on. Only a counter says
+    so: Claude Code leaves it out of a line that does not fit the window (a spinner with none is a Claude writing a long
+    script as often as not), and it shows none while Claude thinks or compacts. */
+export const stalled = (pace, inHand, mark, now) => Boolean(pace?.tokens && !pace.thinking && !pace.compacting && !inHand && mark && now - mark.at >= STALL_MS);

package/public/style.css

@@ -1591,6 +1591,8 @@ html[data-design="v3"] .now-col.col-full { /* v3: .panel rounds and frames it ot
 .chat-run:hover { color: var(--text); }
 .chat-run-t { min-width: 0; overflow-wrap: anywhere; } /* wraps: cut with «…», a long line hid what Claude did */
 .chat-run-file { color: var(--field-text); }
+.chat-run:has(> .chat-run-times) > .chat-run-t { flex: none; max-width: calc(100% - 20px); } /* the times give way first: a pixel taken off the words wrapped them */
+.chat-run-times { flex: 0 1 auto; min-width: 0; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; font-size: 11.5px; opacity: .8; font-variant-numeric: tabular-nums; }
 .chat-run-time { flex: none; white-space: nowrap; font-variant-numeric: tabular-nums; }
 .chat-run > svg { flex: none; transform: rotate(-90deg); transition: transform .15s ease; }
 .chat-run.open > svg { transform: none; }
@@ -1637,12 +1639,15 @@ html[data-design="v3"] .now-col.col-full { /* v3: .panel rounds and frames it ot
 /* a narrow column: the words give way with an ellipsis, the dot never does (a squeezed dot went out of sight) */
 .chat-working .chat-pulse { flex: none; }
 .chat-working-t { flex: 0 1000 auto; min-width: min(7.5em, 40%); overflow: hidden; white-space: nowrap; text-overflow: ellipsis; }
-.chat-working-now { flex: 1 1 auto; min-width: 4em; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; color: var(--field-text); }
+.chat-working-m { flex: 0 1 auto; min-width: 0; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; font-variant-numeric: tabular-nums; }
+.chat-working-now { flex: 1 100 auto; min-width: 4em; overflow: hidden; white-space: nowrap; text-overflow: ellipsis; color: var(--field-text); }
 .chat-live { display: flex; flex-direction: column; gap: 6px; }
 .chat-live:empty { display: none; }
 .chat-going { display: flex; flex-direction: column; gap: 2px; max-height: 30vh; overflow-y: auto; }
-.chat-pulse { position: relative; width: 7px; height: 7px; border-radius: 50%; background: var(--doing); }
-.chat-pulse::after { content: ''; position: absolute; inset: 0; border-radius: 50%; background: var(--doing); animation: chat-pulse 1.4s ease-out infinite; }
+.chat-pulse { position: relative; width: 7px; height: 7px; border-radius: 50%; background: var(--ok); }
+.chat-pulse::after { content: ''; position: absolute; inset: 0; border-radius: 50%; background: var(--ok); animation: chat-pulse 1.4s ease-out infinite; }
+.chat-working.stalled .chat-pulse, .chat-working.stalled .chat-pulse::after { background: var(--doing); }
+.chat-working.stalled .chat-pulse::after { animation: none; }
 @keyframes chat-pulse { from { transform: scale(1); opacity: .6; } to { transform: scale(2.6); opacity: 0; } }
 .chat-empty { padding: 14px 4px; font-size: 12.5px; }
 .chat-earlier { align-self: center; }

package/src/chat-feed.js

@@ -376,14 +376,26 @@ export async function saidCommand(path, code) {
   return null;
 }
 
+const WROTE_MIN_MS = 3000;
+const WROTE_MAX_MS = 30 * 60_000;
 /** The turns of a chat from its items, oldest first: [{at, user, images?, items, ms, open, compact?}]. A turn begins
     with the person's words (or a compacted conversation); `ms` — how long Claude worked, from Claude Code's own line;
     `open` — no such line yet: Claude is on it, or it was stopped. Steps get their outcome: `ms`, `error`, and the answer
-    to a question of Claude's. */
+    to a question of Claude's; `wrote` — how long Claude took to write the step. */
 export function chatTurns(items) {
   const calls = new Map();
   const byTask = new Map(); // id of background work → its call
-  for (const it of items) if (it.kind === 'tool') { calls.set(it.id, it); if (it.bg) it.running = true; }
+  let before = null;
+  for (const it of items) {
+    if (it.kind === 'tool') {
+      calls.set(it.id, it);
+      if (it.bg) it.running = true;
+      // Claude thinking and writing it. Moments are not told (a second step of one answer), a pause of hours is no work
+      const took = before === null ? 0 : it.at - before;
+      if (took >= WROTE_MIN_MS && took <= WROTE_MAX_MS) it.wrote = took;
+    }
+    before = it.at;
+  }
   for (const it of items) {
     const call = (it.kind === 'result' || it.kind === 'notified') && calls.get(it.id);
     if (!call) continue;

package/src/health.js

@@ -66,16 +66,18 @@ async function measure(path, kind, seen, out, { from = null, hop = 0 } = {}) {
   }
 }
 
-async function rulesIn(dir, seen, out) {
+/** The rules of `dir` that load at the start; with `scoped` (the project's folder), those with `paths:` go there. */
+async function rulesIn(dir, seen, out, scoped = null) {
   let entries;
   try { entries = await readdir(dir, { withFileTypes: true }); } catch { return; }
   for (const e of entries.sort((a, b) => a.name.localeCompare(b.name))) {
     const p = join(dir, e.name);
-    if (e.isDirectory()) { await rulesIn(p, seen, out); continue; }
+    if (e.isDirectory()) { await rulesIn(p, seen, out, scoped); continue; }
     if (!e.name.endsWith('.md')) continue;
     const got = await readMemory(p);
-    if (!got || ruleIsScoped(got.text)) continue;
-    await measure(p, 'rule', seen, out);
+    if (!got) continue;
+    if (!ruleIsScoped(got.text)) await measure(p, 'rule', seen, out);
+    else if (scoped) scoped.list.push({ path: relative(scoped.top, p), kind: 'scoped', chars: got.text.length, lines: lineCount(got.text) });
   }
 }
 
@@ -154,13 +156,14 @@ export async function projectHealth(dir, skip = new Set()) {
     for (const f of files.slice(before)) if (f.kind === 'main') f.name = relative(top, expandPath(f.path));
     await measure(join(d, 'CLAUDE.local.md'), 'local', seen, files);
   }
-  await rulesIn(join(top, '.claude', 'rules'), seen, files);
+  const scoped = { top, list: [] };
+  await rulesIn(join(top, '.claude', 'rules'), seen, files, scoped);
   await memoryOf(top, files);
   const main = files.find((f) => f.kind === 'main') || null;
   return {
     main: main && { path: main.name, chars: main.chars, lines: main.lines },
     files, chars: sum(files, 'chars'), lines: sum(files, 'lines'),
-    nested: await nestedOf(top, seen),
+    nested: [...await nestedOf(top, seen), ...scoped.list].sort((a, b) => b.chars - a.chars),
   };
 }
 

package/src/phantom.js

@@ -449,7 +449,10 @@ export function noteLook(sid) { looked.set(sid, Date.now()); }
 const lookedLately = (sid) => Date.now() - (looked.get(sid) ?? -Infinity) < lookHold;
 
 export const ASK_FRESH_MS = 3000;
+export const CHAT_COLS = 72;
 const asked = new Map(); // sid → Map(width → ms of its last ask)
+/** Whether a terminal of `sid` is on a screen: a viewer asked for its width just now. */
+export const watched = (sid, now = Date.now()) => [...(asked.get(sid)?.values() ?? [])].some((at) => now - at <= ASK_FRESH_MS);
 /** The width to lay the window of `sid` out to, now that a viewer asked for `cols`. */
 export function widthFor(sid, cols, now = Date.now()) {
   let widths = asked.get(sid);
@@ -576,6 +579,29 @@ export function turnOverOnScreen(screen) {
   if (!/^\s{2,}\S/.test(last)) return false; // only an indented line continues the one above it
   return TURN_OVER.test(`${above.at(-2) ?? ''} ${last.trim()}`.replace(/\s+/g, ' '));
 }
+const SPINNER = /^\s*[·✢✳✶✻✽*]\s.*…\s*\((?:\d+h ?)?(?:\d+m ?)?\d+s(?: · ([^)]*))?/;
+const SPINNER_LINES = 14;
+const SPINNER_TOKENS = /[↓↑]\s*([\d.]+)\s*([km]?)\s*tokens?/i;
+/** What the spinner says: {tokens?, thinking?, compacting?} — null when there is none on the screen. */
+export function paceOnScreen(screen) {
+  const lines = shownLines(screen);
+  const above = abovePromptBox(lines, 8);
+  if (above.length === lines.length) return null;
+  for (let i = above.length - 1; i >= Math.max(0, above.length - SPINNER_LINES); i--) {
+    const joined = `${above[i]} ${(above[i + 1] ?? '').trim()}`;
+    const m = SPINNER.exec(joined);
+    if (!m) continue;
+    const said = m[1] ?? '';
+    const n = SPINNER_TOKENS.exec(said);
+    return {
+      ...(n ? { tokens: Math.round(Number(n[1]) * { '': 1, k: 1e3, m: 1e6 }[n[2].toLowerCase()]) } : {}),
+      ...(/\bth(?:inking|ought)\b/.test(said) ? { thinking: true } : {}),
+      ...(/compacting/i.test(joined) ? { compacting: true } : {}),
+    };
+  }
+  return null;
+}
+
 const LIMIT_HIT = /\b(?:usage|5-hour|weekly|session|opus|sonnet|plan) limit reached|\bhit your (?:[\w-]+ )?limit/i;
 // "resets 12:50am", "resets at 3pm", "resets Oct 9 at 10am", "resets Oct 9, 10am"
 const LIMIT_RESETS = /resets?(?: at)? ((?:[a-z]{3,9} \d{1,2},? (?:at )?)?\d{1,2}(?::\d{2})?\s?(?:am|pm)?)/i;

package/src/routes/chat.js

@@ -1,6 +1,6 @@
 
 import { resolveTask, taskAttachmentPaths } from './tasks.js';
-import { REPLY_MAX, claudeAtPrompt, phantomScreen, phantomSend, taskTerminal } from '../phantom.js';
+import { CHAT_COLS, REPLY_MAX, claudeAtPrompt, paceOnScreen, phantomResize, phantomScreen, phantomSend, taskTerminal, watched } from '../phantom.js';
 import { SESSION_ID_RE, taskSessions, transcriptNow } from '../claude-sessions.js';
 import { PICTURE_MAX, PICTURE_TYPES, SHOT_RE, TURNS_DEFAULT, TURNS_MAX, chatHash, chatPicture, chatShot, pictureKindOf, saidCommand, transcriptChat, watchChat } from '../chat-feed.js';
 import { createReadStream } from 'node:fs';
@@ -128,8 +128,11 @@ export default async function chatRoutes(app) {
     if (!working) chat.waiting = [];
     const body = { session: s.session_id, sessions: list, ...chat, queue: queued(s.session_id), send, state, working, own, ...(question ? { question } : {}), ...(choice ? { choice } : {}), ...(ended ? { ended } : {}) };
     const v = chatHash(body);
-    if (seen === v) return { same: true, v };
-    return { ...body, v };
+    const pace = state === 'busy' ? paceOnScreen((await phantomScreen(s.session_id, 0)) ?? '') : null;
+    if (state === 'busy' && CHAT_COLS > (term.cols ?? 0) + 2 && !watched(s.session_id)) await phantomResize(s.session_id, CHAT_COLS);
+    const live = pace ? { pace } : {};
+    if (seen === v) return { same: true, v, ...live };
+    return { ...body, ...live, v };
   });
 
   /** The type of a picture by its first bytes (PNG, JPEG, GIF, WebP), null for anything else. */

package/src/routes/system.js

@@ -40,9 +40,20 @@ function selfPkg() {
 }
 
 export function isNewer(candidate, current) {
-  const nums = (v) => String(v).split('-')[0].split('.').map((n) => parseInt(n, 10) || 0);
-  const [a, b] = [nums(candidate), nums(current)];
-  for (let i = 0; i < 3; i++) if ((a[i] || 0) !== (b[i] || 0)) return (a[i] || 0) > (b[i] || 0);
+  const parse = (v) => {
+    const [core, ...pre] = String(v).split('-');
+    return { nums: core.split('.').map((n) => parseInt(n, 10) || 0), pre: pre.length ? pre.join('-').split('.') : null };
+  };
+  const [a, b] = [parse(candidate), parse(current)];
+  for (let i = 0; i < 3; i++) if ((a.nums[i] || 0) !== (b.nums[i] || 0)) return (a.nums[i] || 0) > (b.nums[i] || 0);
+  if (!a.pre || !b.pre) return !a.pre && !!b.pre;
+  for (let i = 0; i < Math.max(a.pre.length, b.pre.length); i++) {
+    const [x, y] = [a.pre[i], b.pre[i]];
+    if (x === y) continue;
+    if (x === undefined || y === undefined) return y === undefined;
+    if (/^\d+$/.test(x) && /^\d+$/.test(y)) return Number(x) > Number(y);
+    return x > y;
+  }
   return false;
 }