@rt-tools/agent-kit 0.18.0 → 0.19.0

package/assets/laws/verifiability.md

@@ -109,3 +109,8 @@
   судит место, выведенное из-под проверки, — здесь выведено не место, а вся она, и следа в коде
   не остаётся никакого. Расхождение закрывается тем, на что проверка указала, а несогласие с ней
   самой — вопрос к владельцу.
+- **Правка вида проверяется на каждом пороге раскладки, а не на одной ширине.** Пороги — это
+  места, где раскладка меняется, и промах живёт ровно там: по обе стороны от порога она
+  собирается по-разному, а посередине выглядит верной. Проверенная на двух крайних ширинах
+  правка отвечает только про эти две, и всё, что между ними, не видел никто. Пары вокруг порога
+  проверяются обе: одна ширина говорит лишь про ту сторону, на которую попала.

package/assets/patterns/browser-verification-measure.md

@@ -48,6 +48,52 @@ description: Паттерн правила browser-verification. Брать, к
 главной сайта. Счёт годится любому наследуемому свойству: смотрится не одно значение, а число
 узлов с неожиданным.
 
+## Замер по всем порогам разом
+
+Замер по одной ширине за вызов даёт числа разных минут: между вызовами страница
+перерисовывается, и сравнивать их нельзя. Ширины поэтому гоняются пачкой в одном заходе —
+каждая живёт своим кадром, замер снимается со всех сразу:
+
+```javascript
+await (async (address, widths, row) => {
+    const frames = widths.map((width) => {
+        const frame = document.createElement('iframe');
+        frame.style.cssText = `width:${width}px;height:900px;border:0;position:fixed;left:-9999px`;
+        frame.src = address;
+        document.body.appendChild(frame);
+        return { width, frame };
+    });
+
+    await Promise.all(frames.map(({ frame }) => new Promise((done) => (frame.onload = done))));
+
+    return frames.map(({ width, frame }) => {
+        const view = frame.contentWindow;
+        const doc = frame.contentDocument;
+        const cells = [...doc.querySelectorAll(row)];
+
+        return {
+            asked: width,
+            got: view.innerWidth,
+            heights: [...new Set(cells.map((el) => Math.round(el.getBoundingClientRect().height)))],
+            scrolls: doc.documentElement.scrollWidth > doc.documentElement.clientWidth,
+            escaped: cells.filter((el) => el.getBoundingClientRect().left > view.innerWidth).length,
+        };
+    });
+})('/screen', [360, 599, 600, 904, 905, 1239, 1240, 1440], '.field');
+```
+
+Ответ читается по трём признакам, и первый не про вид:
+
+- **высоты соседей одной строки равны между собой** — набор значений в `heights` длиной больше
+  единицы означает, что поля встали разного размера;
+- **поперечной прокрутки нет** — `scrolls` истинно там, где содержимое шире кадра;
+- **ни одна левая граница не выходит за ширину кадра** — `escaped` больше нуля. На снимке этого
+  не видно вовсе: элемент за правым краем выглядит отсутствующим.
+
+Ширина кадра меньше заказанной на полосу прокрутки, поэтому сравнивают с `got`, а не с числом
+из списка: порог, названный по заказанной ширине, на кадре оказывается по другую сторону от
+себя.
+
 ## Узкий экран
 
 `resize_window` не работает, когда Chrome в полноэкранном режиме: инструмент рапортует успех,

package/assets/patterns/git-workflow-commit.github.md

@@ -26,6 +26,20 @@ description: Паттерн правила git-workflow. Брать на зав
 
 Все четыре шага делает одна команда дерева, а не рука: делить их значит забывать третий.
 
+**Локальные ветки этой задачи читаются до заведения новой.** Борда не видит ветки, и задача, по
+которой работа лежит доделанной в локальной ветке, выглядит открытой у всех: колонку двигают
+рукой, заявки нет, а ветка видна только на той машине, где её завели. Под один номер так
+завелась вторая ветка со своей папкой задачи и своим замыслом — то есть работа была спланирована
+второй раз, и выбирать из двух пришлось владельцу.
+
+```bash
+git branch --list '<КЛЮЧ>-<номер>-*'
+```
+
+Одна строка ответа означает, что работа уже начата: её состояние читается в ходе работы её
+папки, а не заводится заново. Пустой ответ говорит только про эту машину — ветка, заведённая на
+другой и не отданная хостингу, не видна и отсюда.
+
 **Очередь работ спрашивается до заведения задачи, а не после.** Найденное собственной сверкой
 ощущается новым, и это ощущение — единственное, что стоит за решением завести задачу: команда
 заведения отвечает за свои вызовы и о содержании очереди не знает ничего. Спрашивается она

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rt-tools/agent-kit",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Переносимый слой правил для агента: законы, хуки, проверки и агенты, раскладываемые в репозиторий одной командой",
   "author": "RT Team",
   "license": "Apache-2.0",