cc-viewer 1.6.182 → 1.6.183

package/concepts/uk/Tool-ExitWorktree.md

@@ -0,0 +1,41 @@
+# ExitWorktree
+
+Завершує сеанс worktree, раніше створений за допомогою `EnterWorktree`, і повертає сеанс до вихідного робочого каталогу. Цей інструмент діє виключно на worktree, створені `EnterWorktree` у поточному сеансі; якщо такого активного сеансу немає, виклик не дає жодного ефекту.
+
+## Коли використовувати
+
+- Роботу в ізольованому worktree завершено і потрібно повернутися до основного робочого каталогу.
+- Завдання у worktree гілки функціональності виконано і після злиття потрібно видалити гілку та каталог.
+- Потрібно зберегти worktree для подальшого використання і просто повернутися до вихідного каталогу без видалення чого-небудь.
+- Потрібно відмовитися від експериментальної або тимчасової гілки, не залишаючи артефактів на диску.
+- Перед запуском нового сеансу `EnterWorktree` необхідно спочатку завершити поточний.
+
+## Параметри
+
+- `action` (рядок, обов'язковий): `"keep"` зберігає каталог worktree і гілку на диску, щоб можна було повернутися до них пізніше; `"remove"` видаляє і каталог, і гілку, виконуючи чисте завершення.
+- `discard_changes` (логічне значення, необов'язковий, типово `false`): Має значення лише при `action: "remove"`. Якщо worktree містить незафіксовані файли або коміти, відсутні у вихідній гілці, інструмент відмовить у видаленні, якщо `discard_changes` не встановлено в `true`. Відповідь про помилку містить перелік конкретних змін, щоб ви могли підтвердити їх із користувачем перед повторним викликом.
+
+## Приклади
+
+### Приклад 1: чисте завершення після злиття змін
+
+Після завершення роботи у worktree та злиття гілки в main викличте `ExitWorktree` з `action: "remove"`, щоб видалити каталог worktree і гілку та повернутися до вихідного робочого каталогу.
+
+```
+ExitWorktree(action: "remove")
+```
+
+### Приклад 2: відмова від тимчасового worktree з незафіксованим експериментальним кодом
+
+Якщо worktree містить експериментальні незафіксовані зміни, які потрібно повністю відкинути, спочатку спробуйте `action: "remove"`. Інструмент відмовить і перелічить незафіксовані зміни. Після підтвердження користувача, що зміни можна відкинути, викличте знову з `discard_changes: true`.
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## Примітки
+
+- Цей інструмент діє виключно на worktree, створені `EnterWorktree` у поточному сеансі. Він не вплине на worktree, створені за допомогою `git worktree add`, worktree з попередніх сеансів або звичайний робочий каталог, якщо `EnterWorktree` ніколи не викликався — у цих випадках виклик не дає ефекту.
+- `action: "remove"` буде відхилено, якщо worktree має незафіксовані зміни або коміти, відсутні у вихідній гілці, якщо тільки `discard_changes: true` не вказано явно. Завжди підтверджуйте з користувачем перед встановленням `discard_changes: true`, оскільки дані не підлягають відновленню.
+- Якщо до worktree було прикріплено сеанс tmux: при `remove` він завершується; при `keep` продовжує роботу, а його ім'я повертається, щоб користувач міг підключитися знову пізніше.
+- Після завершення `ExitWorktree` можна знову викликати `EnterWorktree` для запуску нового сеансу worktree.

package/concepts/uk/Tool-Glob.md

@@ -1,39 +1,35 @@
 # Glob
 
-## Визначення
+Зіставляє імена файлів з глоб-шаблоном і повертає шляхи, відсортовані за часом останньої модифікації (спочатку найновіші). Оптимізований для швидкого знаходження файлів у кодових базах будь-якого розміру без виклику `find`.
 
-Швидкий інструмент зіставлення шаблонів імен файлів, що підтримує кодові бази будь-якого розміру. Повертає шляхи файлів, що збіглися, відсортовані за часом модифікації.
+## Коли використовувати
 
-## Параметри
+- Перелічення кожного файлу певного розширення (наприклад, усі файли `*.ts` під `src`)
+- Виявлення файлів конфігурації чи фікстур за угодою іменування (`**/jest.config.*`, `**/*.test.tsx`)
+- Звуження області пошуку перед запуском цілеспрямованого `Grep`
+- Перевірка, чи файл уже існує за відомим шаблоном, перед викликом `Write`
+- Пошук нещодавно змінених файлів, покладаючись на впорядкування за часом модифікації
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `pattern` | string | Так | Шаблон glob (наприклад, `**/*.js`, `src/**/*.ts`) |
-| `path` | string | Ні | Каталог пошуку, за замовчуванням поточний робочий каталог. Не передавайте "undefined" або "null" |
+## Параметри
 
-## Сценарії використання
+- `pattern` (string, обовʼязковий): Глоб-вираз для зіставлення. Підтримує `*` для односегментних підстановок, `**` для рекурсивних збігів і `{a,b}` для альтернатив, наприклад `src/**/*.{ts,tsx}`.
+- `path` (string, необовʼязковий): Каталог, у якому виконувати пошук. Має бути дійсним шляхом каталогу, коли надається. Опустіть поле повністю, щоб шукати в поточному робочому каталозі. Не передавайте рядки `"undefined"` чи `"null"`.
 
-**Підходить для:**
-- Пошук файлів за шаблоном імені файлу
-- Пошук усіх файлів певного типу (наприклад, усіх файлів `.tsx`)
-- Локалізація файлу при пошуку конкретного визначення класу (наприклад, `class Foo`)
-- Можна паралельно запускати кілька викликів Glob в одному повідомленні
+## Приклади
 
-**Не підходить для:**
-- Пошук вмісту файлів — слід використовувати Grep
-- Відкрите дослідження, що потребує кількох раундів — слід використовувати Task (тип Explore)
+### Приклад 1: Кожен TypeScript-файл вихідного коду
+Викличте `Glob` з `pattern: "src/**/*.ts"`. Результат — список, відсортований за mtime, тому нещодавно відредаговані файли зʼявляються першими, що корисно для фокусування на гарячих точках.
 
-## Примітки
+### Приклад 2: Знаходження кандидата на визначення класу
+Коли ви підозрюєте, що клас живе у файлі, імені якого не знаєте, шукайте з `pattern: "**/*UserService*"`, щоб звузити кандидатів, потім продовжіть `Read` чи `Grep`.
 
-- Підтримує стандартний синтаксис glob: `*` збігається з одним рівнем, `**` з кількома рівнями, `{}` для множинного вибору
-- Результати відсортовані за часом модифікації
-- Рекомендується більше, ніж команда `find` у Bash
+### Приклад 3: Паралельне виявлення перед більшим завданням
+В одному повідомленні видайте кілька викликів `Glob` (наприклад, один для `**/*.test.ts` і один для `**/fixtures/**`), щоб обидва виконувалися паралельно і їхні результати можна було корелювати.
 
-## Оригінальний текст
+## Примітки
 
-<textarea readonly>- Fast file pattern matching tool that works with any codebase size
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns matching file paths sorted by modification time
-- Use this tool when you need to find files by name patterns
-- When you are doing an open ended search that may require multiple rounds of globbing and grepping, use the Agent tool instead
-- You can call multiple tools in a single response. It is always better to speculatively perform multiple searches in parallel if they are potentially useful.</textarea>
+- Результати впорядковані за часом модифікації файлу (спочатку найновіші), не за алфавітом. Сортуйте далі, якщо вам потрібне стабільне впорядкування.
+- Шаблони оцінюються інструментом, не оболонкою; вам не потрібно брати їх у лапки чи екранувати, як у командному рядку.
+- Для відкритого дослідження, що вимагає кількох раундів пошуку та міркування, делегуйте `Agent` з типом агента Explore замість зчеплення багатьох викликів `Glob`.
+- Віддавайте перевагу `Glob` над викликами `Bash` з `find` чи `ls` для виявлення імен файлів; він послідовно обробляє дозволи та повертає структурований вивід.
+- Коли шукаєте вміст усередині файлів, а не імена файлів, використовуйте `Grep`.

package/concepts/uk/Tool-Grep.md

@@ -1,57 +1,46 @@
 # Grep
 
-## Визначення
+Шукає вміст файлів, використовуючи рушій ripgrep. Пропонує повну підтримку регулярних виразів, фільтрацію за типом файлу та три режими виводу, щоб ви могли обміняти точність на компактність.
 
-Потужний інструмент пошуку вмісту на основі ripgrep. Підтримує регулярні вирази, фільтрацію за типом файлу та кілька режимів виводу.
+## Коли використовувати
+
+- Пошук кожного місця виклику функції чи кожного посилання на ідентифікатор
+- Перевірка, чи зʼявляється рядок чи повідомлення про помилку будь-де в кодовій базі
+- Підрахунок входжень шаблону для оцінки впливу перед рефакторингом
+- Звуження пошуку до типу файлу (`type: "ts"`) чи глоба (`glob: "**/*.tsx"`)
+- Отримання багаторядкових збігів, таких як багаторядкові визначення struct чи блоки JSX з `multiline: true`
 
 ## Параметри
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `pattern` | string | Так | Шаблон пошуку регулярного виразу |
-| `path` | string | Ні | Шлях пошуку (файл або каталог), за замовчуванням поточний робочий каталог |
-| `glob` | string | Ні | Фільтр імені файлу (наприклад, `*.js`, `*.{ts,tsx}`) |
-| `type` | string | Ні | Фільтр типу файлу (наприклад, `js`, `py`, `rust`), ефективніший за glob |
-| `output_mode` | enum | Ні | Режим виводу: `files_with_matches` (за замовчуванням), `content`, `count` |
-| `-i` | boolean | Ні | Пошук без урахування регістру |
-| `-n` | boolean | Ні | Показувати номери рядків (лише режим content), за замовчуванням true |
-| `-A` | number | Ні | Кількість рядків після збігу |
-| `-B` | number | Ні | Кількість рядків перед збігом |
-| `-C` / `context` | number | Ні | Кількість рядків до та після збігу |
-| `head_limit` | number | Ні | Обмеження кількості записів виводу, за замовчуванням 0 (без обмежень) |
-| `offset` | number | Ні | Пропустити перші N результатів |
-| `multiline` | boolean | Ні | Увімкнути багаторядковий режим зіставлення, за замовчуванням false |
-
-## Сценарії використання
-
-**Підходить для:**
-- Пошук конкретних рядків або шаблонів у кодовій базі
-- Пошук місць використання функцій/змінних
-- Фільтрація результатів пошуку за типом файлу
-- Підрахунок кількості збігів
-
-**Не підходить для:**
-- Пошук файлів за іменем — слід використовувати Glob
-- Відкрите дослідження, що потребує кількох раундів — слід використовувати Task (тип Explore)
+- `pattern` (string, обовʼязковий): Регулярний вираз для пошуку. Використовує синтаксис ripgrep, тому літеральні фігурні дужки потребують екранування (наприклад, `interface\{\}`, щоб знайти `interface{}`).
+- `path` (string, необовʼязковий): Файл чи каталог для пошуку. За замовчуванням — поточний робочий каталог.
+- `glob` (string, необовʼязковий): Фільтр імен файлів, такий як `*.js` чи `*.{ts,tsx}`.
+- `type` (string, необовʼязковий): Скорочення типу файлу, таке як `js`, `py`, `rust`, `go`. Ефективніше за `glob` для стандартних мов.
+- `output_mode` (enum, необовʼязковий): `files_with_matches` (за замовчуванням, повертає лише шляхи), `content` (повертає рядки зі збігами) або `count` (повертає підрахунки збігів).
+- `-i` (boolean, необовʼязковий): Зіставлення без урахування регістру.
+- `-n` (boolean, необовʼязковий): Включати номери рядків у режимі `content`. За замовчуванням `true`.
+- `-A` (number, необовʼязковий): Рядки контексту для показу після кожного збігу (потребує режиму `content`).
+- `-B` (number, необовʼязковий): Рядки контексту перед кожним збігом (потребує режиму `content`).
+- `-C` / `context` (number, необовʼязковий): Рядки контексту з обох боків кожного збігу.
+- `multiline` (boolean, необовʼязковий): Дозволяє шаблонам охоплювати перенесення рядків (`.` відповідає `\n`). За замовчуванням `false`.
+- `head_limit` (number, необовʼязковий): Обмежує повернуті рядки, шляхи файлів чи записи підрахунку. За замовчуванням 250; передайте `0` для необмеженої кількості (використовуйте обережно).
+- `offset` (number, необовʼязковий): Пропускає перші N результатів перед застосуванням `head_limit`. За замовчуванням `0`.
+
+## Приклади
+
+### Приклад 1: Знаходження всіх місць виклику функції
+Встановіть `pattern: "registerHandler\\("`, `output_mode: "content"` та `-C: 2`, щоб побачити навколишні рядки кожного виклику.
+
+### Приклад 2: Підрахунок збігів у типі
+Встановіть `pattern: "TODO"`, `type: "py"` та `output_mode: "count"`, щоб побачити загальну кількість TODO по файлах у вихідних кодах Python.
+
+### Приклад 3: Багаторядковий збіг struct
+Використовуйте `pattern: "struct Config \\{[\\s\\S]*?version"` з `multiline: true`, щоб захопити поле, оголошене на кілька рядків у Go-struct.
 
 ## Примітки
 
-- Використовує синтаксис ripgrep (не grep), спеціальні символи як фігурні дужки потребують екранування
-- Режим `files_with_matches` повертає лише шляхи файлів, найефективніший
-- Режим `content` повертає вміст рядків зі збігами, підтримує контекстні рядки
-- Для багаторядкового зіставлення потрібно встановити `multiline: true`
-- Завжди надавайте перевагу інструменту Grep замість команд `grep` або `rg` у Bash
-
-## Оригінальний текст
-
-<textarea readonly>A powerful search tool built on ripgrep
-
-  Usage:
-  - ALWAYS use Grep for search tasks. NEVER invoke `grep` or `rg` as a Bash command. The Grep tool has been optimized for correct permissions and access.
-  - Supports full regex syntax (e.g., "log.*Error", "function\s+\w+")
-  - Filter files with glob parameter (e.g., "*.js", "**/*.tsx") or type parameter (e.g., "js", "py", "rust")
-  - Output modes: "content" shows matching lines, "files_with_matches" shows only file paths (default), "count" shows match counts
-  - Use Agent tool for open-ended searches requiring multiple rounds
-  - Pattern syntax: Uses ripgrep (not grep) - literal braces need escaping (use `interface\{\}` to find `interface{}` in Go code)
-  - Multiline matching: By default patterns match within single lines only. For cross-line patterns like `struct \{[\s\S]*?field`, use `multiline: true`
-</textarea>
+- Завжди віддавайте перевагу `Grep` над запуском `grep` чи `rg` через `Bash`; інструмент оптимізований для правильних дозволів та структурованого виводу.
+- Типовий режим виводу — `files_with_matches`, який найдешевший. Переключайтеся на `content`, лише коли вам потрібно побачити самі рядки.
+- Прапорці контексту (`-A`, `-B`, `-C`) ігноруються, якщо `output_mode` не `content`.
+- Великі набори результатів витрачають контекстні токени. Використовуйте `head_limit`, `offset` чи жорсткіші фільтри `glob`/`type`, щоб залишатися сфокусованими.
+- Для виявлення імен файлів використовуйте натомість `Glob`; для відкритих досліджень у багато раундів диспетчеризуйте `Agent` з агентом Explore.

package/concepts/uk/Tool-Monitor.md

@@ -0,0 +1,50 @@
+# Monitor
+
+Запускає фоновий монітор, який передає події від тривалого скрипту. Кожен рядок стандартного виводу стає сповіщенням — продовжуйте працювати, поки події надходять у чат.
+
+## Коли використовувати
+
+- Відстеження помилок, попереджень або сигнатур збоїв у файлі журналу під час виконання розгортання
+- Опитування віддаленого API, PR або конвеєра CI кожні 30 секунд для виявлення нових подій стану
+- Спостереження за змінами в каталозі файлової системи або у виводі збірки в реальному часі
+- Очікування певної умови протягом багатьох ітерацій (наприклад, контрольна точка кроку навчання або спорожнення черги)
+- **Не** для простого "чекати до завершення" — для цього використовуйте `Bash` з `run_in_background`; він надсилає одне сповіщення про завершення, коли процес завершується
+
+## Параметри
+
+- `command` (рядок, обов'язковий): Команда оболонки або скрипт для запуску. Кожен рядок, записаний у стандартний вивід, стає окремою подією сповіщення. Монітор завершується, коли завершується процес.
+- `description` (рядок, обов'язковий): Коротка читабельна мітка, що відображається в кожному сповіщенні. Бути конкретним — "помилки в deploy.log" краще, ніж "спостереження за журналами". Ця мітка визначає, який монітор спрацював.
+- `timeout_ms` (число, за замовчуванням `300000`, макс `3600000`): Кінцевий термін примусового завершення в мілісекундах. Після цього часу процес завершується. Ігнорується при `persistent: true`.
+- `persistent` (логічне, за замовчуванням `false`): Коли `true`, монітор працює протягом усього часу сесії без тайм-ауту. Зупинити явно за допомогою `TaskStop`.
+
+## Приклади
+
+### Приклад 1: Відстеження файлу журналу на наявність помилок і збоїв
+
+Цей приклад охоплює всі кінцеві стани: маркер успіху, зворотне трасування, поширені ключові слова помилок, завершення через OOM і несподіхваний вихід процесу.
+
+```bash
+tail -F /var/log/deploy.log | grep -E --line-buffered \
+  "deployed|Traceback|Error|FAILED|assert|Killed|OOM"
+```
+
+Використовувати `grep --line-buffered` у кожному конвеєрі. Без цього ОС буферизує вивід блоками по 4 КБ і події можуть затримуватися на хвилини. Шаблон чергування охоплює як шлях успіху (`deployed`), так і шляхи збою (`Traceback`, `Error`, `FAILED`, `Killed`, `OOM`). Монітор, що спостерігає лише за маркером успіху, мовчить під час збою — мовчання нерозрізненне від "все ще працює".
+
+### Приклад 2: Опитування віддаленого API кожні 30 секунд
+
+```bash
+while true; do
+  curl -sf "https://api.example.com/status" || true
+  sleep 30
+done | grep --line-buffered -E "completed|failed|error"
+```
+
+`|| true` запобігає завершенню циклу через тимчасовий збій мережі. Інтервали опитування 30 секунд і більше підходять для віддалених API, щоб уникнути обмежень частоти запитів. Налаштувати шаблон grep для захоплення як успішних, так і помилкових відповідей, щоб помилки на стороні API не маскувалися мовчанням.
+
+## Примітки
+
+- **Завжди використовувати `grep --line-buffered` у конвеєрах.** Без цього буферизація конвеєра затримує події на хвилини, оскільки ОС накопичує вивід до заповнення блоку 4 КБ. `--line-buffered` примусово скидає буфер після кожного рядка.
+- **Фільтр повинен охоплювати як сигнатури успіху, так і збою.** Монітор, що спостерігає лише за маркером успіху, мовчить при збої, зависанні або несподіваному виході. Розширити чергування: включити `Error`, `Traceback`, `FAILED`, `Killed`, `OOM` і подібні маркери кінцевого стану поряд із ключовим словом успіху.
+- **Інтервали опитування: 30 секунд і більше для віддалених API.** Часте опитування зовнішніх сервісів ризикує отримати помилки обмеження частоти запитів або блокування. Для локальних перевірок файлової системи або процесів підходить 0,5–1 секунда.
+- **Використовувати `persistent: true` для моніторів на час сесії.** Стандартний `timeout_ms` у 300 000 мс (5 хвилин) завершує процес. Для моніторів, які повинні працювати до явної зупинки, встановити `persistent: true` і викликати `TaskStop` після завершення.
+- **Автоматична зупинка при потоці подій.** Кожен рядок стандартного виводу — це повідомлення в розмові. Якщо фільтр занадто широкий і виробляє занадто багато подій, монітор зупиняється автоматично. Перезапустити з більш строгим шаблоном `grep`. Рядки, що надходять протягом 200 мс, об'єднуються в одне сповіщення.

package/concepts/uk/Tool-NotebookEdit.md

@@ -1,33 +1,39 @@
 # NotebookEdit
 
-## Визначення
+Модифікує одну клітинку в Jupyter-ноутбуці (`.ipynb`). Підтримує заміну вихідного коду клітинки, вставку нової клітинки або видалення наявної клітинки зі збереженням решти структури ноутбука.
 
-Замінює, вставляє або видаляє конкретну комірку в Jupyter notebook (файл .ipynb).
+## Коли використовувати
+
+- Виправлення чи оновлення клітинки з кодом в аналітичному ноутбуці без переписування всього файлу
+- Заміна markdown-клітинки для покращення оповіді чи додавання документації
+- Вставка нової клітинки з кодом чи markdown у відому позицію в наявному ноутбуці
+- Видалення застарілої чи зламаної клітинки, щоб подальші клітинки більше не залежали від неї
+- Підготовка відтворюваного ноутбука шляхом ітерацій над клітинками по одній
 
 ## Параметри
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `notebook_path` | string | Так | Абсолютний шлях до файлу notebook |
-| `new_source` | string | Так | Новий вміст комірки |
-| `cell_id` | string | Ні | ID комірки для редагування. У режимі вставки нова комірка вставляється після цього ID |
-| `cell_type` | enum | Ні | Тип комірки: `code` або `markdown`. Обов'язковий у режимі вставки |
-| `edit_mode` | enum | Ні | Режим редагування: `replace` (за замовчуванням), `insert`, `delete` |
+- `notebook_path` (string, обовʼязковий): Абсолютний шлях до файлу `.ipynb`. Відносні шляхи відхиляються.
+- `new_source` (string, обовʼязковий): Новий вихідний код клітинки. Для `replace` та `insert` стає тілом клітинки; для `delete` ігнорується, але все одно вимагається схемою.
+- `cell_id` (string, необовʼязковий): ID цільової клітинки. У режимах `replace` та `delete` інструмент діє на цю клітинку. У режимі `insert` нова клітинка вставляється одразу після клітинки з цим ID; опустіть, щоб вставити на початку ноутбука.
+- `cell_type` (enum, необовʼязковий): Або `code`, або `markdown`. Обовʼязковий, коли `edit_mode` — `insert`. Коли опущено під час `replace`, тип наявної клітинки зберігається.
+- `edit_mode` (enum, необовʼязковий): `replace` (за замовчуванням), `insert` або `delete`.
 
-## Сценарії використання
+## Приклади
 
-**Підходить для:**
-- Зміна коду або markdown комірок у Jupyter notebook
-- Додавання нових комірок до notebook
-- Видалення комірок з notebook
+### Приклад 1: Заміна баґової клітинки з кодом
+Викличте `NotebookEdit` з `notebook_path`, встановленим на абсолютний шлях, `cell_id`, встановленим на ID цільової клітинки, та `new_source`, що містить виправлений код Python. Залиште `edit_mode` за замовчуванням `replace`.
 
-## Примітки
+### Приклад 2: Вставка markdown-пояснення
+Щоб додати markdown-клітинку одразу після наявної клітинки `setup`, встановіть `edit_mode: "insert"`, `cell_type: "markdown"`, `cell_id` на ID клітинки setup і помістіть оповідь у `new_source`.
 
-- `cell_number` має індексацію з 0
-- Режим `insert` вставляє нову комірку у вказану позицію
-- Режим `delete` видаляє комірку у вказаній позиції
-- Шлях повинен бути абсолютним
+### Приклад 3: Видалення застарілої клітинки
+Встановіть `edit_mode: "delete"` і надайте `cell_id` клітинки для видалення. Надайте будь-який рядок для `new_source`; його не буде застосовано.
 
-## Оригінальний текст
+## Примітки
 
-<textarea readonly>Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.</textarea>
+- Завжди передавайте абсолютний шлях. `NotebookEdit` не розвʼязує відносні шляхи відносно робочого каталогу.
+- Інструмент переписує лише цільову клітинку; лічильники виконання, виводи та метадані для непов'язаних клітинок залишаються недоторканими.
+- Вставка без `cell_id` розміщує нову клітинку на самому початку ноутбука.
+- `cell_type` обовʼязковий для вставок. Для замін опускайте його, якщо ви явно не хочете перетворити клітинку з кодом на markdown або навпаки.
+- Щоб перевірити клітинки та отримати їхні ID, використовуйте спочатку інструмент `Read` на ноутбуці; він повертає клітинки з їхнім вмістом та виводами.
+- Використовуйте звичайний `Edit` для простих файлів вихідного коду; `NotebookEdit` специфічний для JSON `.ipynb` і розуміє його структуру клітинок.

package/concepts/uk/Tool-PushNotification.md

@@ -0,0 +1,48 @@
+# PushNotification
+
+Надсилає сповіщення на робочий стіл із поточної сесії Claude Code. Якщо підключено Remote Control, сповіщення також надходить на телефон користувача, привертаючи його увагу назад до сесії — чим би він не займався.
+
+## Коли використовувати
+
+- Тривале завдання завершилось, поки користувач, найімовірніше, був відсутній біля терміналу
+- Збірка, запуск тестів або розгортання завершено і результат готовий до перевірки
+- Досягнуто точки прийняття рішення, яка потребує участі користувача перед тим, як продовжити роботу
+- Виникла помилка або блокування, яке неможливо вирішити автономно
+- Користувач явно попросив сповістити його, коли певне завдання або умова буде виконано
+
+## Коли не використовувати
+
+Не надсилайте сповіщення для рутинних оновлень про хід виконання завдання та не підтверджуйте ним відповідь на запитання, яке користувач щойно поставив і явно очікує. Не сповіщайте про завершення коротких завдань — якщо користувач щойно відправив завдання й чекає, сповіщення не несе жодної цінності й підриває довіру до майбутніх сповіщень. Наполегливо схиляйтеся до того, щоб не надсилати.
+
+## Параметри
+
+- `message` (рядок, обов'язковий): текст сповіщення. Тримайте в межах 200 символів; мобільні операційні системи обрізають довші рядки. Починайте з того, на що користувач реагуватиме: "build failed: 2 auth tests" інформативніше, ніж "task complete".
+- `status` (рядок, обов'язковий): завжди встановлюйте значення `"proactive"`. Це фіксований маркер і він не змінюється.
+
+## Приклади
+
+### Приклад 1: сповіщення після завершення тривалого аналізу
+
+Було запрошено аудит залежностей по всьому репозиторію, який тривав кілька хвилин. Користувач відійшов від робочого місця. Коли звіт готовий:
+
+```
+message: "Аудит залежностей завершено: 3 критичні CVE в lodash, axios, jsonwebtoken. Звіт: audit-report.txt"
+status: "proactive"
+```
+
+### Приклад 2: позначення точки прийняття рішення під час автономної роботи
+
+Під час багатоетапного рефакторингу виявлено, що два модулі мають конфліктуючі інтерфейси і не можуть бути об'єднані без проектного рішення:
+
+```
+message: "Рефакторинг призупинено: AuthService і UserService мають конфліктуючі інтерфейси токенів. Потрібне ваше рішення для продовження."
+status: "proactive"
+```
+
+## Примітки
+
+- Наполегливо схиляйтеся до того, щоб **не** надсилати. Сповіщення перериває користувача незалежно від того, чим він займається. Розглядайте це як витрату, яку необхідно виправдати цінністю інформації.
+- Починайте з вмісту, що спонукає до дії. Перші слова мають повідомляти користувачу, що сталося і що, якщо щось потрібно зробити — а не загальний статусний ярлик.
+- Тримайте `message` в межах 200 символів. Мобільні операційні системи обрізають довші рядки, і найважливіша частина може бути втрачена, якщо вона знаходиться в кінці.
+- Якщо результат вказує на те, що push не був надісланий через відсутність підключення Remote Control, це очікувана поведінка. Повторна спроба або додаткові дії не потрібні; локальне сповіщення на робочому столі все одно спрацьовує.
+- Уникайте спаму сповіщень. Якщо сповіщення часто надсилаються через незначні події, користувач почне їх ігнорувати. Зберігайте цей інструмент для моментів, коли є реальна вірогідність того, що користувач відійшов і захоче дізнатися результат зараз.

package/concepts/uk/Tool-Read.md

@@ -1,56 +1,41 @@
 # Read
 
-## Визначення
+Завантажує вміст одного файлу з локальної файлової системи. Підтримує простий текст, вихідний код, зображення, PDF та Jupyter-ноутбуки, повертаючи результати з номерами рядків на основі 1 у стилі `cat -n`.
 
-Читає вміст файлу з локальної файлової системи. Підтримує текстові файли, зображення, PDF та Jupyter notebook.
+## Коли використовувати
+
+- Читання файлу вихідного коду за відомим шляхом перед редагуванням чи аналізом
+- Перегляд файлів конфігурації, lockfile, логів чи згенерованих артефактів
+- Перегляд скріншотів чи діаграм, які користувач вставив у розмову
+- Витягування конкретного діапазону сторінок з довгого PDF-посібника
+- Відкриття ноутбука `.ipynb` для спільного перегляду клітинок з кодом, markdown та виводів клітинок
 
 ## Параметри
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `file_path` | string | Так | Абсолютний шлях до файлу |
-| `offset` | number | Ні | Початковий номер рядка (для посегментного читання великих файлів) |
-| `limit` | number | Ні | Кількість рядків для читання (для посегментного читання великих файлів) |
-| `pages` | string | Ні | Діапазон сторінок PDF (наприклад, "1-5", "3", "10-20"), лише для PDF |
+- `file_path` (string, обовʼязковий): Абсолютний шлях до цільового файлу. Відносні шляхи відхиляються.
+- `offset` (integer, необовʼязковий): Номер рядка на основі 1, з якого почати читання. Корисно для великих файлів у парі з `limit`.
+- `limit` (integer, необовʼязковий): Максимальна кількість рядків для повернення, починаючи з `offset`. За замовчуванням 2000 рядків з початку файлу, коли опущено.
+- `pages` (string, необовʼязковий): Діапазон сторінок для файлів PDF, наприклад `"1-5"`, `"3"` чи `"10-20"`. Обовʼязковий для PDF довших за 10 сторінок; максимум 20 сторінок на запит.
+
+## Приклади
+
+### Приклад 1: Читання маленького файлу повністю
+Викличте `Read` лише з `file_path`, встановленим на `/Users/me/project/src/index.ts`. До 2000 рядків повертається з номерами рядків, чого зазвичай достатньо для контексту редагування.
 
-## Сценарії використання
+### Приклад 2: Посторінкове читання довгого логу
+Використовуйте `offset: 5001` і `limit: 500` на багатотисячному лог-файлі, щоб отримати вузьке вікно без марнування контекстних токенів.
 
-**Підходить для:**
-- Читання текстових файлів: файлів коду, конфігураційних файлів тощо
-- Перегляд файлів зображень (Claude — мультимодальна модель)
-- Читання PDF-документів
-- Читання Jupyter notebook (повертає всі комірки та їх вивід)
-- Паралельне читання кількох файлів для отримання контексту
+### Приклад 3: Витягування конкретних сторінок PDF
+Для 120-сторінкового PDF за `/tmp/spec.pdf` встановіть `pages: "8-15"`, щоб вилучити лише потрібний розділ. Опущення `pages` на великому PDF призведе до помилки.
 
-**Не підходить для:**
-- Читання каталогу — слід використовувати команду `ls` у Bash
-- Відкрите дослідження кодової бази — слід використовувати Task (тип Explore)
+### Приклад 4: Перегляд зображення
+Передайте абсолютний шлях скріншоту PNG чи JPG. Зображення відображається візуально, щоб Claude Code міг міркувати про нього безпосередньо.
 
 ## Примітки
 
-- Шлях повинен бути абсолютним, не відносним
-- За замовчуванням читає перші 2000 рядків файлу
-- Рядки довші за 2000 символів будуть обрізані
-- Вивід у форматі `cat -n`, нумерація рядків починається з 1
-- Для великих PDF (понад 10 сторінок) обов'язково вказувати параметр `pages`, максимум 20 сторінок за раз
-- Читання неіснуючого файлу поверне помилку (не призведе до збою)
-- Можна паралельно викликати кілька Read в одному повідомленні
-
-## Оригінальний текст
-
-<textarea readonly>Reads a file from the local filesystem. You can access any file directly by using this tool.
-Assume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.
-
-Usage:
-- The file_path parameter must be an absolute path, not a relative path
-- By default, it reads up to 2000 lines starting from the beginning of the file
-- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters
-- Any lines longer than 2000 characters will be truncated
-- Results are returned using cat -n format, with line numbers starting at 1
-- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.
-- This tool can read PDF files (.pdf). For large PDFs (more than 10 pages), you MUST provide the pages parameter to read specific page ranges (e.g., pages: "1-5"). Reading a large PDF without the pages parameter will fail. Maximum 20 pages per request.
-- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.
-- This tool can only read files, not directories. To read a directory, use an ls command via the Bash tool.
-- You can call multiple tools in a single response. It is always better to speculatively read multiple potentially useful files in parallel.
-- You will regularly be asked to read screenshots. If the user provides a path to a screenshot, ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths.
-- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.</textarea>
+- Завжди віддавайте перевагу абсолютним шляхам. Якщо користувач надає один, довіряйте йому як є.
+- Рядки довші за 2000 символів обрізаються; розглядайте повернутий вміст як потенційно обрізаний для дуже широких даних.
+- Читаєте кілька незалежних файлів? Видайте кілька викликів `Read` в одній відповіді, щоб вони виконувалися паралельно.
+- `Read` не може перелічувати каталоги. Використовуйте виклик `Bash` `ls` чи інструмент `Glob` натомість.
+- Читання наявного, але порожнього файлу повертає системне нагадування, а не байти файлу, тому обробляйте цей сигнал явно.
+- Успішний `Read` потрібен перед тим, як ви зможете використовувати `Edit` на тому самому файлі в поточній сесії.

package/concepts/uk/Tool-RemoteTrigger.md

@@ -0,0 +1,73 @@
+# RemoteTrigger
+
+Викликає API віддалених тригерів claude.ai для керування запланованими завданнями та виконанням тригерів на вимогу. Токен OAuth обробляється інструментом внутрішньо і ніколи не передається моделі або оболонці.
+
+## Коли використовувати
+
+- Керування віддаленими агентами (тригерами) на claude.ai, включаючи перегляд списку, перевірку та оновлення існуючих тригерів
+- Створення нового автоматизованого завдання на основі cron, яке запускає агента Claude за повторюваним розкладом
+- Запуск існуючого тригера на вимогу без очікування наступного запланованого виконання
+- Відображення або аудит усіх поточних тригерів для перегляду їхньої конфігурації та стану
+- Оновлення налаштувань тригера, таких як розклад, корисне навантаження або опис, без необхідності його повторного створення
+
+## Параметри
+
+- `action` (string, обов'язковий): операція, яку необхідно виконати — одне з значень `list`, `get`, `create`, `update` або `run`
+- `trigger_id` (string, обов'язковий для `get`, `update` та `run`): ідентифікатор тригера, над яким виконується операція; повинен відповідати шаблону `^[\w-]+$` (лише символи слів і дефіси)
+- `body` (object, обов'язковий для `create` і `update`; необов'язковий для `run`): корисне навантаження запиту, що надсилається до API
+
+## Приклади
+
+### Приклад 1: отримати список усіх тригерів
+
+```json
+{
+  "action": "list"
+}
+```
+
+Викликає `GET /v1/code/triggers` і повертає масив JSON усіх тригерів, пов'язаних з аутентифікованим обліковим записом.
+
+### Приклад 2: створити новий тригер, що запускається кожного ранку в робочий день
+
+```json
+{
+  "action": "create",
+  "body": {
+    "name": "weekday-morning-report",
+    "schedule": "0 8 * * 1-5",
+    "description": "Генерувати щоденний підсумок кожного робочого дня о 08:00 UTC"
+  }
+}
+```
+
+Викликає `POST /v1/code/triggers` із наданим тілом запиту і повертає щойно створений об'єкт тригера, включаючи призначений `trigger_id`.
+
+### Приклад 3: запустити тригер на вимогу
+
+```json
+{
+  "action": "run",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Негайно викликає `POST /v1/code/triggers/my-report-trigger/run`, обминаючи запланований час.
+
+### Приклад 4: отримати один тригер
+
+```json
+{
+  "action": "get",
+  "trigger_id": "my-report-trigger"
+}
+```
+
+Викликає `GET /v1/code/triggers/my-report-trigger` і повертає повну конфігурацію тригера.
+
+## Примітки
+
+- Токен OAuth вводиться інструментом усередині процесу — ніколи не копіюйте, не вставляйте і не записуйте токени вручну; це створює загрозу безпеці і є зайвим при використанні цього інструменту.
+- Використовуйте цей інструмент замість прямого `curl` або інших HTTP-клієнтів для всіх викликів API тригерів; пряме використання HTTP обходить безпечне введення токена і може розкрити облікові дані.
+- Інструмент повертає необроблену відповідь JSON від API; викликаюча сторона відповідає за розбір відповіді та обробку кодів стану помилок.
+- Значення `trigger_id` повинно відповідати шаблону `^[\w-]+$` — дозволені лише буквено-цифрові символи, підкреслення та дефіси; пробіли або спеціальні символи призведуть до помилки запиту.