Команди

Кожна команда нижче — це інтерфейс до того самого реєстру плагінів і того самого SQLite-сховища, і кожна з них уже працює. Підкоманда, плагін якої не вкомпільовано (наприклад, rtok run без feature cmd), виводить not implemented і завершується з кодом 0, тож урізана збірка ніколи не блокує хост.

Сторінка Graph

Сторінка Graph у rtok dashboard малює граф коду у два рівні: об'ємною 3D-сценою, пласкою 2D-сценою або звичайним списком (вибір запам'ятовується; без WebGL сторінка показує 2D і пояснює чому).

• Усі проєкти. Вузол на кожен зареєстрований проєкт, лінія на кожен зв'язок. Правий клік по вузлу дає Select, Open, Re-index, Remove…, Fly to і Copy path; подвійний клік відкриває проєкт. Re-index запускає rtok graph projects reindex у воркері: поки він іде, вузол має стан indexing, а старі рядки відповідають далі; потім ok або failed з помилкою. Remove… показує dry run rtok graph projects remove (рядки індексу й зв'язки, що підуть; файли не чіпає) і видаляє лише після підтвердження. У rtok tui ті самі дві дії є на сторінці Graph.
• Один проєкт. Файли — куби, типи й модулі — октаедри, функції — сфери, кожен кольору свого проєкту й згрупований за текою. Клік вибирає вузол; клік по вибраному файлу розкриває його визначення, по вибраній функції — ставить на неї фокус (викликачі й викликані на глибину від одного до чотирьох викликів, кнопки глибини). Виклик у пов'язаний проєкт закінчується контурним вузлом кольору того проєкту; клік по ньому відкриває той проєкт із символом у фокусі. +N more піднімає ліміт вузлів на 500. ⚠ позначає файл, змінений після останньої індексації, а доки такі файли є, банер повідомляє, що картина неповна.
• Бічна панель і пошук. Панель вибраного вузла показує шлях і рядок, сигнатуру, викликачів і викликаних (інші кінці ребер calls на картинці; клік по одному вибирає його) та посилання Open in editor, vscode://file/<root>/<path>:<line>. Для вузла пов'язаного проєкту посилання будується від кореня того проєкту, а Open in <project> заходить у нього. Поле пошуку надсилає текст за Enter (простий набір нічого не шле) і перелічує збіги в проєкті та пов'язаних проєктах, кожен із проєктом; збіг у цьому проєкті отримує фокус, збіг в іншому відкриває той проєкт із символом у фокусі.
• Де ви — видно в адресі. Проєкт, розкриті файли, фокус і глибина лежать в URL сторінки: кожен крок — запис історії, хлібні крихти (All projects / rtok / src/plugins/graph) повертають назад, а скопійоване посилання відкриває той самий вигляд.
• Стани індексу. Непроіндексований проєкт показує команду (rtok graph index --project <id>) і заповнюється, коли індекс готовий; проєкт зі зниклою текою малюється порожнім контуром і не відкривається. Доки watch переіндексовує, сторінка питає знову й оновлюється на місці, не зсуваючи сцену.
• Порівняння. Кнопка Compare на панелі проєкту просить у сервера той самий звіт, що й rtok graph diff (сторінка нічого не перераховує), і фарбує картинку: додане зеленим +, видалене червоним − (контурним привидом у розгорнутому файлі, бо в робочому дереві його вже нема), змінене жовтим ~, переміщене синім →; файл бере єдину зміну своїх символів, різні види роблять його зміненим, а доданий чи прибраний виклик — зелена або червона пунктирна лінія. Кожна зміна має і знак у підписі, і слово в підказці та списку, тож колір — не єдина ознака. Бічна панель дає лічильники, змінені (сигнатура або тіло) та видалені символи з їхніми викликачами, перейменовані, переміщені й додані символи, ребра викликів, додані та прибрані зв'язки й файли changed, not analysed. Стара сторона — HEAD, посилання або PROJECT:REF з поля (іде по Enter) чи збережений rtok graph export --level symbols, обраний через вибір файлу: сторінка сама читає файл і шле його текст, а не шлях, тому ніщо через /ws не змусить rtok відкрити файл. Проти експорту перелічуються лише додані та видалені символи й зв'язки. Кожен список обрізається на 500 рядків на проєкт (панель каже, скільки ще; усе є в rtok graph diff). Граф наживо далі працює; вимкнення Compare повертає попередню картинку.
• Граф наживо. Поруч з оглядачем (одне під одним за ширини менше 900 px) друга картинка лише для читання показує, що роблять інструменти графа, за викликами, що надходять по /ws. Вона малює той самий рівень, що й оглядач, з тим самим розкладом і кольорами: зареєстровані проєкти або відкритий проєкт. Вводу вона не приймає (ні вказівника, ні колеса, ні клавіш, курсор лишається звичайною стрілкою). Виклик підсвічує вузол проєкту на огляді або вузол з назвою його цілі у вигляді одного проєкту: кільце на кожен виклик, що виконується, одного з восьми акцентів, німб для викликів за останні 5 хвилин і червоне кільце в того, що впав; понад вісім викликів, що виконуються, лічильник «busy» показує, скільки ще. До першого виклику картинка затемнена й підписана «Waiting for graph calls». Камера бере в кадр вузли викликів, що виконуються, і викликів, що завершилися за останні 4 секунди, і плавно повертається до загальної картини, коли таких не лишилося (за prefers-reduced-motion вона перемикається стрибком). Кнопки «2D» і «3D» у куті картинки перемикають вигляд; 3D це той самий Three.js, що в частині 1, без обертання й вибору: німб для нагріву, оболонка на кожен виклик, що виконується, і червоний каркас у того, що впав; без WebGL показується 2D зі сповіщенням. У кожного виклику, що виконується, є невеликий підпис на його вузлі, у 2D і в 3D: інструмент і лічильник секунд; завершений виклик зберігає підпис із тривалістю 4 секунди й згасає після 2, виклик, згорнутий у «+N more», підписує вузол, що тримає лічильник, а виклик поза областю підпису не має. Смуга між частинами змінює їхній розмір (перетягування, стрілки, подвійний клік повертає 50/50) і запам'ятовується; «Hide live graph» ховає картинку й завершує підписку на /ws, це теж запам'ятовується. Сторінка підписується, лише доки граф наживо показано. Нижче: виклики, що виконуються, виклики й збої, надіслані токени, токени без rtok і зекономлене, стовпці за інструментами та частки бекендів за останні 1, 5 або 15 хвилин чи від запуску rtok web: підсумки читаються зі сховища, тож після перезавантаження сторінки цифри ті самі (сховище тримає 5000 останніх подій викликів, давніші виклики з підсумків випадають). На екранах вужче за 900 px, де жива частина лягає під оглядач, ці числа згортаються в один рядок (виконується, виклики, зекономлено), який розгортає повні картки й знову їх згортає; від 900 px і ширше нічого не змінюється. Підсумки беруться з summary кожного кадру й рядків вимірювань graph, тож вікно збігається з rtok stats за тими самими викликами (стовпці за інструментами та частки бекендів рахують виклики, перелічені в кадрі). Сторінка також рахує запитані символи (і скільки викликів зачепили більше одного проєкту), рядки lsp_fallback і відповіді, обрізані за max_tokens, точно, за summary, а для symbol, callers, impact, outline, explore і graph_diff ще скільки запитаних символів відповіді перелічують (explore запитує по одному на ідентифікатор питання, решта жодного), файли перелічених рядків (місця виклику під зміненим символом у graph_diff рядками дифу не є) і в скількох проєктах є влучання, як їх порахували бекенди графа під час збирання відповіді; затримка (медіана й 95-й процентиль) вимірюється за викликами, які перелічують кадри, останні 1000. «Freeze» заморожує картинку й рахує те, що надходить; «Unfreeze» наздоганяє всі виклики. Стрічка тримає live_feed_rows (200) останніх завершених викликів, фільтрується за викликачем (агент і хост, які сховище назвало для сесії, наприклад claude 3f9a1c2e; процес rtok mcp показано хостом і pid, невідому сховищу сесію — її id), інструментом і проєктом, показує викликів, що впали, червоним і позначає виклик, що не завершився за дві хвилини, як перерваний. Ключі [plugins.graph] live_heat_window_s (300), live_max_events_per_s (50; скільки подій викликів за секунду показує панель, лічильники рахують кожен виклик) і live_feed_rows (200) читаються під час запуску живої частини. Картки «calls» і «saved» мають спарклайн із 30 слотів сервера за обране вікно (за останні 15 хвилин для «since start») з тих самих кошиків, що додаються до підсумків; вони називаються «calls over the last 5 min» і «tokens saved over the last 5 min». Якщо сторінка має область (проєкт, у який зайшли, інакше вибраний, з усім, що сягають його зв'язки), рядок стрічки для проєкту поза нею отримує позначку «outside scope» і не підсвічує полотно. На вигляді одного проєкту, коли ліміт у 500 вузлів сховав частину вузлів, виклик на схованому рахується під «folded calls» на намальованому файлі, чий шлях містить ціль виклику, інакше на групі «+N more».
• Тривоги. Коли перевірка здоров'я (див. LSP-бекенд) піднімає тривогу для проєкту, його вузол отримує червоний значок на обох рівнях (червоний маркер у 3D, а в списку й підказці — слово alert), так само як кожен зв'язок до нього й кожен контурний символ цього проєкту на вигляді одного проєкту. Список тривог угорі сторінки — один рядок на вид тривоги («share-1, share-2, share-3 unreachable since 14:02 (3 projects)»). Спливне сповіщення з'являється, коли знімок піднімає або знімає тривогу, і зникає за кілька секунд або за Dismiss; тривоги, що вже горіли під час відкриття сторінки, потрапляють у список, але без сповіщення.
• Бекенд графа. У кожного проєкту в списку стоїть lsp або tags, а заголовок вибраного проєкту пояснює чому: мову, чий сервер відповідає, або причину відкату на теги, час останньої перевірки й час наступної спроби health check. Проєкт, про який ще ніхто не питав, так і пише, що запису немає.

Кожен прапорець — це ключ конфігурації

Немає прапорця, який не можна зробити постійним. rtok proxy --port 8791 і [proxy] port = 8791 — це те саме налаштування, задане двома способами, а rtok config show --sources повідомляє, який рівень переміг. Ланцюжок пріоритетів описано в Конфігурації.

Скорочення і повернення назад

rtok run -- <cmd> виконує команду, архівує сирий вивід і друкує відфільтровану версію з доданим id. rtok expand <id> друкує початкові дані назад. Ця пара — увесь контракт збереження без втрат: ніщо, що скорочує rtok, не втрачається безповоротно.

Вимірювання

rtok stats читає таблицю measurements. Рядки надходять від плагінів, що викликають Ctx::record з Measurement, і від проксі, який фіксує реальне usage з відповідей API. rtok stats --calibrate заново підганяє оцінювач «символів на токен» під ці реальні лічильники.

rtok bench запускає дві конфігурації хоста на фіксованому наборі задач у bench/tasks.toml і порівнює їх.

Події викликів графа

rtok dashboard показує, що роблять інструменти графа. Кожен виклик symbol, callers, impact, outline і explore у будь-якому процесі rtok (MCP-сервер, rtok mcp --call) пише в сховище подію початку, подію прогресу та подію кінця. Дашборд читає нові події кожні 250 мс і надсилає їх через /ws кадрами {"type":"calls"}, тому виклик з іншого процесу видно протягом секунди (обидва строки перевіряє tests/web_live.rs). Сторінка вмикає кадри повідомленням {"calls":{"subscribe":true}} і вимикає значенням false; поки жоден сокет не підписаний, нічого не читається.

Подія кінця містить інструмент, символ, проєкт і бекенд (lsp, tags або text, береться із заголовка відповіді; для фіксованого режиму порожньо), час виконання, оцінку токенів відповіді та рядки вимірювань graph, які записав виклик (samples: вид, байти й оцінка токенів до і після). Це ті самі рядки, що показує rtok stats --plugin graph. Невдалий виклик завершується з ok: false і текстом помилки. У подіях лише імена, шляхи й числа, без вихідного коду.

У кадрі не більше 100 подій. Під час сплеску початок і прогрес завершеного виклику згортаються в його кінець, а summary кадру рахує кожен виклик опитування, тож підсумки не гублять події. Повторного надсилання немає: сокет бачить події, записані після підписки (перший кадр порожній і несе номер останньої події), а підсумок за вікно читається зі сховища. Сховище тримає останні 5000 подій.