В итогах сентября я писал, что у Lekalo готов прототип. Теперь у проекта есть версия 1.0.0 — релиз вышел 25 октября. Пора рассказать, зачем я его делаю, что уже можно попробовать и что именно проверено в первом большом выпуске.
Зачем мне понадобилось своё «лекало»
Когда работаешь над приложением, приходится держать в голове много связей: какие есть сущности, что с ними можно делать, кому разрешено менять данные, от чего зависит конкретная часть кода. С появлением AI-помощников хочется ещё и передать им этот контекст в понятном виде.
Для этого я делаю Lekalo. В основе — явная модель приложения: его сущности, действия, права и зависимости. Её можно проверять, связывать с существующим кодом, смотреть, чего коснётся изменение, и собирать контекст для следующей задачи.
Название хорошо передаёт задумку: сначала разобраться с формой и связями, затем работать с деталями. О прототипе я упоминал в итогах сентября; сейчас уже есть отдельный инструмент командной строки и документация по его использованию.
Что довёл до 1.0.0
После предыдущего релиза 0.8.15 главным шагом стал цельный пользовательский сценарий. В 1.0.0 можно подключить существующий TypeScript-проект, получить сведения о его коде, явно подтвердить связи с моделью и пройти до запуска проверок. Этот путь описан в руководстве по полному сценарию.
Подключение с заданными границами. Можно указать, какие каталоги включать в анализ, а какие исключить. Предварительное подключение оставляет исходники приложения неизменными.
Модель и существующий код работают вместе. Сканирование TypeScript помогает найти связи, а разработчик подтверждает, каким частям модели они соответствуют. После этого доступны проверка модели, просмотр связей, анализ влияния изменений и подготовка контекста.
Инструкции для AI-помощника. Команда lekalo install prompt устанавливает управляемое руководство и ссылку на него в AGENTS.md. У инструкций проверяется актуальность, а обновление учитывает, кому принадлежит файл.
Запуск проверок по подтверждённому плану. План привязан к конкретным исходникам, настройкам, адаптеру и инструментам. После отдельного подтверждения команды запускаются в изолированной временной копии. В отчёте остаются реальные результаты, вывод и сведения об очистке. Зависимости нужно подготовить заранее.
Для модели при этом не обязательны HTTP-маршруты и база данных: можно описывать и локальную логику приложения. Состав релиза 1.0.0.
Что получилось в проверках
Для релиза опубликовано пять архивов: Windows x64, Linux x64 и ARM64, macOS Intel и Apple Silicon. Все пять сборок и проверка публикации завершились успешно.
Отдельно проверен именно готовый Windows-бинарник, извлечённый из опубликованного архива. Он прошёл полный демонстрационный сценарий вне рабочего Git-репозитория: четыре подтверждённые связи с моделью и четыре успешно выполненные команды. Исходные файлы сохранились, временная рабочая копия была очищена.
В сохранённом отчёте этого запуска есть и время команд:
| Команда | Инструмент | Время из отчёта |
|---|---|---|
| Тесты основной логики | Vitest 5.0.5 | 2669 мс |
| Проверка типов основной логики | TypeScript 5.9.3 | 1774 мс |
| Сборка клиента | Vite 8.3.5 | 1085 мс |
| Проверка типов клиента | TypeScript 5.9.3 | 1074 мс |
Это время выполнения команд в отчёте Lekalo для одного небольшого учебного проекта на Windows x64 и Node 24.13.0. Оно не равно внутреннему таймеру самого Vitest или Vite и не является сравнением скорости разных версий.
Насколько Lekalo помогает быстрее решать реальные задачи вместе с AI-помощником, ещё предстоит измерить. Такая проверка вынесена в следующий этап.
Что означает первая версия
Для меня 1.0.0 — рубеж, на котором описанный рабочий путь собран и проверен. У него есть конкретные границы: выполнение команд поддерживается на Windows x64 с подготовленным Node 24 и настроенной изоляцией. На Linux и macOS доступны предусмотренные сценарии анализа и работы с моделью; выполнение команд там пока не поддерживается. Автоматическая генерация экранов остаётся в планах.
Попробовать можно с релиза 1.0.0 и инструкции по установке. На странице Lekalo соберу описание проекта и историю его развития.
