Repository navigation
Description
Зачем
Код писался быстро и большими мазками; владелец прочитал ядро и корни и оставил 58 замечаний (комментарии от 2026-10-09 ниже). Почти все сводятся к трём вещам: нет записанных стандартов, слои перемешаны, написано руками то, что умеют библиотеки. Ревью должно дать не список придирок, а три результата.
Три результата
| № | Результат | В каком виде |
|---|---|---|
| 1 | Стандарт кода | docs/conventions/code.md: по правилу на вопрос «как у нас принято», и к каждому правилу — проверка ast-grep (или тест архитектуры там, где ast-grep не может) |
| 2 | Карта слоёв, к которой идём | что такое ycli.core (обобщённое, без слова «Яндекс», с расчётом на перенос в refract), что остаётся в ycli.yandex, куда уходят sync и status, что уезжает из ycli.cli и ycli.mcp в ядро; вместе с #508 |
| 3 | Ответ на каждое из 58 замечаний | таблица: замечание → что в коде на самом деле (файл:строка) → вердикт «исправить / обсудить / оставить и объяснить» → чем заменить |
Находки сверх замечаний идут в тот же отчёт теми же тремя вердиктами.
Состояние на старте
- main
3599fd91(0.142.0), открытых PR нет; начатая работа закрыта (feat!: every listing takeslimit, everything andnexton the SDK, the CLI and the MCP server #534, fix(tracker):projects createno longer demands--queues, which the service accepts and ignores #563–feat(sdk):client.plan(...)gives the request a call would send, andwith_optionssets a call's options #577). - Этап 0 (замер) сделан:
~/.cache/ycli-research/techdebt/out/3599fd91/—SUMMARY.md,dossier/<область>.md(19),cross-area.md,parameters.csv,ways.md,graph-top.md,ycli.cc.json,codecharta.png,raw/. Перезапуск одной командой:~/.cache/ycli-research/techdebt/bin/measure.sh [COMMIT](около 3,5 минут; что есть что — вREADME.mdрядом). - Измеренное дерево:
~/.cache/ycli-research/techdebt/wt-3599fd91— по нему открываютсяфайл:строкаиз досье. - Хвосты, найденные по дороге: Хвосты после закрытия начатой работы 10 октября: что отложено, что ждёт решения, что нашлось попутно #575.
Что показал замер (наводки, не выводы)
| Что | Результат |
|---|---|
| Размер | 145 тысяч строк Python; из них 26,5 тысячи — сгенерированный слой DataLens |
| Повторы без сгенерированного слоя | 14,1 % кода, 245 групп; 168 пересекают области |
| Повторы между сервисами | 89 групп, почти все в models.py: Forms + Tracker 39, Tracker + Wiki 32, Forms + Wiki 15 |
| Список параметров операции | 471 операция; у 435 записан во всех четырёх слоях; у 99 команда собирает тело из опций руками |
| Сложность функций | низкая: 7 функций за порогом цикломатической; когнитивная ≥ 15 — в скриптах (25), проверках (19), e2e (11), ядре (8), корнях (8) |
| Мёртвый код | три инструмента не сходятся ни в одном месте |
| Сервис импортирует другой сервис | ни разу; но каждый сервис импортирует ycli.cli (DataLens 30, Tracker 20, Forms 17, Wiki 9) |
Где стандарт уже есть, но не записан: X | None (3867, Optional — 0), @cache (14, других нет), модели сервисов — только pydantic (457). Где его нет: псевдонимы типов (type X = 10 против ~360 присваиваний), место опций команд (все восемь сочетаний typedefs.py / верх cli.py / подпись), имена «дай объект» (135 голых слов, get_* — 0), функции и константы на уровне модуля. Всё это с местами — в ways.md.
Области
Агент читает область целиком в одном контексте, поэтому ориентир — до 10 тысяч строк.
| Область | Файлов | Строк | Модель |
|---|---|---|---|
core (yandex/core, models, sync, status, модули верхнего уровня, settings.py) |
45 | 8 522 | Opus |
roots-cli-mcp (ycli/cli, ycli/mcp) |
28 | 3 900 | Opus |
| tracker-1 (applications … dashboards) | 72 | 5 780 | Sonnet |
| tracker-2 (entities … issues) | 30 | 7 252 | Sonnet |
| tracker-3 (issuetypes … worklog) | 112 | 8 781 | Sonnet |
| forms | 105 | 9 633 | Sonnet |
| wiki | 72 | 7 859 | Sonnet — пилот |
| datalens-1 (audit … entries), рукописный | 73 | 7 529 | Sonnet |
| datalens-2 (entrylocks … workbooks), рукописный | 103 | 7 619 | Sonnet |
| scripts (генераторы, дрейф API) | 11 | 5 984 | Sonnet |
| tests-checks-1, tests-checks-2 (архитектура, контракт, инструменты, документация) | 52 | 10 503 | Sonnet × 2 |
| tests-unit-core-cli-mcp-1, -2 | 75 | 13 354 | Sonnet × 2 |
| tests-unit-tracker | 91 | 9 152 | Sonnet |
| tests-unit-datalens | 69 | 6 452 | Sonnet |
| tests-unit-forms-wiki | 64 | 6 009 | Sonnet |
| e2e (Python и сценарии YAML) | 11 | 2 172 | Sonnet |
Сгенерированный слой DataLens (26 523 строки) не читается: читается его генератор в scripts. Корни отданы Opus вместе с ядром, потому что почти все замечания владельца — про эти две области.
Этапы
| Этап | Что | Агенты |
|---|---|---|
| 0. Замер | сделан | — |
| 1. Пилот | область wiki целиком; цель — отладить задание и формат находок и измерить цену одной области |
1 читатель Sonnet + 1 проверяющий Opus |
| 2. Чтение | остальные 17 областей, волнами по 4–5 одновременно | 15 Sonnet + 2 Opus |
| 3. Сверка с документацией | каждое «библиотека это умеет» — по текущим докам pydantic, typer, httpx2, stamina, rich, fastmcp; отдельно ответ на замечание 58: что из них мы не используем, хотя могли бы | 2 исследователя Sonnet |
| 4. Сведение | один ищет общее между областями (повторы, разные решения одной задачи, кандидаты в стандарт и в ycli.core); второй пытается опровергнуть находки |
2 проверяющих Opus |
| 5. Отчёт | сводный отчёт, таблица ответов на 58 замечаний, карта CodeCharta с числом находок на файл | 1 автор Sonnet |
После отчёта: решения владельца → исправления пачками PR по областям (пишет Sonnet, каждую пачку проверяет Opus и тесты); перестройка слоёв — вместе с #508, пишет Opus.
Цена не измерена: ревью одного PR на 158 файлов стоило около 470 тысяч токенов. Пилот даёт настоящую цифру на область; по ней решается размер волн.
Что получает читатель области
Досье своей области, ways.md, cross-area.md, parameters.csv, ARCHITECTURE.md, docs/conventions/, замечания владельца, относящиеся к его файлам, и список вопросов ниже.
На что смотреть (один список для всех)
- Способы. По каждому пункту
ways.mdв своей области: какой способ — правило, какие места — отступления, и почему. Плюс способы, которых замер не видел. - Слои. Что в файле не принадлежит его слою: ввод-вывод, чтение настроек, знание о соседней поверхности, яндексовое в общем коде и общее в яндексовом. Для ядра — что мешает ему стать
ycli.coreбез слова «Яндекс». - Самодельное вместо библиотечного. pydantic 2 (
Annotated-метаданные, валидаторы и сериализаторы,TypeAdapter, дискриминаторы,validate_call, секреты), typer, fastmcp, httpx2, stamina; Python 3.12+. Утверждение «библиотека умеет» помечается для этапа 3, а не доказывается памятью. - Признаки по строкам. Имена полей, списки имён, правка текста регулярными выражениями, комментарии-метки вместо типизированных объектов (Техдолг: признаки полей — типизированные метки, а не строки, списки имён и правка текста (аудит и исправление) #457).
- Список параметров операции. Где и сколько раз записан, собирается ли тело руками (319 функций с длинным списком аргументов: природа CLI или параметры должны стать объектом — одно решение #562);
parameters.csv— отправная точка. - Повторы. Для каждой группы клонов из досье: совпадение, недостающий механизм или намеренное зеркало CLI и MCP.
- Лишнее. Мёртвый код (каждого кандидата проверить чтением), обёртки в одну строку, параметры, которые никто не передаёт, абстракции с одним пользователем, тесты, проверяющие реализацию вместо поведения.
- Читаемость. Функции уровня модуля и константы — обоснованы ли; длинные функции без логических частей; докстринги, которые пересказывают код; имена.
- Типы.
Any,dict[str, Any],cast,# type: ignore,# noqa— каждое с вопросом «почему нельзя точнее». - Свои же правила.
ARCHITECTURE.md,docs/conventions, решения закрытых issue.
Правила для агентов
- Читать область целиком; что не прочитано — назвать.
- Находка без
файл:строкане принимается. Наводка инструмента подтверждается или опровергается чтением и так и помечается. - Вердикт на каждую находку: исправить / обсудить / оставить и объяснить; к «исправить» — чем заменить.
- Ничего не править, не коммитить, не писать в GitHub. Сгенерированное руками не трогать.
- Писать находки в свой файл по ходу:
~/.cache/ycli-research/techdebt/findings/<область>.md; итог возвращать текстом, а не ссылкой. - Слова вердикта о проверенности: подтверждено / опровергнуто / не удалось проверить.
Замечания владельца: кто отвечает
| Замечания | О чём | Область |
|---|---|---|
| 18–21 | settings.py: функции уровня модуля, система профилей, префикс окружения |
core |
| 22–26 | yandex/base.py: длинный комментарий, проверка через bool, единый объект авторизации вместо трёх аргументов |
core |
| 27–30 | yandex/errors.py: функции и константы уровня модуля, тяжёлые методы |
core |
| 31–32 | yandex/factory.py: проверка без pydantic, фабрика функцией |
core |
| 33–41 | yandex/mcp.py: константы, ввод-вывод в модуле MCP, тяжёлые функции, имена get_* |
core |
| 42–52 | yandex/models.py: Literal[...] | str, поиск по строке, метка Secret(), место для меток, датаклассы меток, единственная ответственность |
core |
| 53–55 | polling.py (почему не stamina), registry.py, service.py (датакласс или pydantic) |
core |
| 56–57, 59–65 | core/: авторизация, токен продолжения, псевдонимы типов, @cache, пагинация как абстракция с базовой реализацией, profile.py, session.py на 500 строк |
core |
| 66 | sync и status под yandex |
core + сведение |
| 67–70 | ycli/cli, ycli/mcp: где лежат опции, транспорт в mcp/http_auth.py, cli/api_response.py, лишнее в корнях |
roots-cli-mcp |
| 25, 58 | pydantic для проверки функций; что не используем из библиотек | этап 3 |
| 70–72 | стандарты и сложность через ast-grep; то же для документации, e2e, скриптов и тестов | сведение |
| 73–75 | smoke_test.py, conftest.py, pyproject.toml |
tests-checks, scripts |
Номера — индексы комментариев с нуля, как их отдаёт gh issue view 459 --json comments --jq '.comments | to_entries[] | "[\(.key)] \(.value.body)"'; замечания владельца — индексы 18–75 (все от 2026-10-09).
Что на выходе
- Отчёт в
docs/с числом находок по областям и видам и с ответами на 58 замечаний. - Черновик
docs/conventions/code.mdи правила ast-grep к нему; каждое правило показано падающим на нарушении. - Карта слоёв — отдельным issue
needs-decisionвместе с Вывод SDK, CLI и MCP из описания операции: итог исследования и пять решений до пробы #508. - Всё, где есть выбор (заменить подход, убрать поверхность, поменять публичное имя), — отдельными issue
needs-decision. - Механические исправления — пачками PR по областям, после решений.
Чего не делать
- Не править код внутри ревью: сначала полный список, потом решения, потом исправления.
- Не начинать волну до пилота и не начинать чтение, если main сдвинулся: сначала перезапустить замер.
- Не решать за владельца то, что меняет публичные имена, поверхности или слои.
Перед стартом: уборка
В репозитории лежат рабочие копии и ветки прошлых сессий: 12 рабочих копий, около 230 локальных веток, 2 старых тайника (git stash) неизвестного содержания. Первым шагом — сверить каждую с main и принести владельцу список «слито / не слито / неизвестно»; удалять только по его слову.
Связанное
#508 (вывод слоёв из описания операции), #562 (список параметров — один раз), #575 (хвосты), #457 (признаки полей), #234, #320, #113.
Activity
bim-ba commentedon Oct 6, 2026
Дополнение (владелец, 2026-10-06): ещё два взгляда для каждого агента
Залепы вместо устройства. Места, где задача решена условием, флагом, функцией-помощником или особым случаем там, где должен быть класс, интерфейс (
Protocol/ABC), наследование или композиция. Признаки:if kind == …по строке вместо полиморфизма; функция с заглавной буквы и# noqa, изображающая класс; параметр-флаг, меняющий смысл вызова; один и тот же набор аргументов, который таскают вместе через несколько функций (значит, это объект); помощники_…вcli.pyиmcp.py, повторяющие друг друга.Унификация. Одно понятие — одно устройство, от которого идут частные случаи. Пример владельца, с которого надо начать:
EndpointиRPCдолжны быть видами одного базового понятияOperation, чтобы к нему же добавлялись другие виды API (gRPC и прочие) — это же связывает ядро с проектомrefract(ARCHITECTURE.md, раздел про refract: уEndpoint[T]та же форма, что уRequestв refract).Как это выглядит сегодня (main
f17029dc,src/ycli/yandex/core/endpoint.py):Endpoint[T]— класс;RPC— функция (с# noqa: N802за заглавную букву), которая возвращаетEndpointс методомPOSTи путёмrpc/<имя>; в её докстринге прямо сказано «one more way to write an Endpoint, not another kind of request». То есть сейчас вид API — это способ записи, а не тип. Агент по ядру должен разобрать: что общего у REST-запроса, RPC-вызова и будущего gRPC (имя операции, эффект, тип ответа, тело), что различается (транспорт, адрес, кодирование), и предложить иерархию или композицию с ценой перехода — сколько файловendpoints.pyи проверок ARCH она затронет.Искать так же по остальному коду: пагинация (восемь классов в
core/pagination.py— это семейство с общим интерфейсом или набор похожих?), ошибки, вход (auth), модели запросов и ответов, корни CLI и MCP.По этим двум пунктам агент не предлагает правку на месте: каждая находка — кандидат в отдельный issue
needs-decisionс вариантами устройства, потому что это меняет архитектуру (ARCHITECTURE.mdи проверки меняются в том же PR).bim-ba commentedon Oct 6, 2026
Стратегия и план (архитектор, 2026-10-06). Запуск — по команде владельца, после полного покрытия DataLens
Стратегия
Сначала машина, потом агенты, потом человек. Всё, что можно найти инструментом, находится инструментом и приходит агентам готовым списком; агенты тратят внимание на то, чего инструмент не видит (устройство, унификация, красота); владелец решает только развилки.
flowchart LR A[0. Заморозка и базовая линия] --> B[1. Машинный проход] B --> C[2. Агенты по областям, параллельно] C --> D[3. Сквозные агенты: дубли и унификация] D --> E[4. Проверяющий поверх всего] E --> F[5. Сводный отчёт и issue] F --> G[6. Решения владельца] G --> H[7. Исправления пачками PR]Этапы
OperationнадEndpointиRPC, пагинация, ошибки, вход; (в) помощники вcli.pyиmcp.pydocs/; находки с выбором — отдельнымиneeds-decision; механические — списком на исправлениеdocs/conventionsи, где возможно, в проверкуЗапускается этап 2 только после того, как черновой прогон этапа 0 показан владельцу.
Какими инструментами (все запускаются через
uv/uvx, версии проверены 2026-10-06)f17029dc, без сгенерированного слоя)ruff0.15.20 со всеми правилами (--select ALL), а не только выбранными в проектеPLR(сложность, число аргументов) 274,PYI296,EM/TRY(исключения) 165,FBT(булевы флаги) 73,ARG(неиспользуемые аргументы) 21ty0.0.55Any— 207 мест,dict[str, Any]— 72,cast(— 9,# noqa— 12,# type: ignore— 0vulture2.16complexipy8.0.1ast-grep0.45.3if x == "строка"по виду, функции с заглавной буквы, одинаковые тела вcli.pyиmcp.py, регулярные выражения по сгенерированному текстуgraphify(граф кода, уже описан вCLAUDE.md)import-linter,tests/architectureЧисла базовой линии — не находки, а размер работы: каждое срабатывание агент оценивает сам.
В какие источники ходят агенты
context7; для Python — «What's New» 3.12–3.14 на docs.python.orgARCHITECTURE.md,docs/conventions/*, закрытые issue с решениями владельца (меткаneeds-decisionснята, комментарий «Решено»)deepwiki— только для вопросов устройства: как там разделены запрос, транспорт и операцияbim-ba/refractи раздел о нём вARCHITECTURE.mdЧего агенты не делают
Не правят код. Не предлагают «исправить на месте» по пунктам 8 и 9 (устройство и унификация) — только варианты для решения. Не пересматривают решения владельца. Не читают сгенерированный слой построчно — его качество оценивается через генератор.
Стоимость (оценка, не замер)
14 агентов; по опыту сегодняшнего исследования исходников DataLens один агент на большом чтении тратит порядка 300 тысяч токенов — весь проход порядка 4–5 миллионов. Точнее скажу после чернового прогона на ядре.
bim-ba commentedon Oct 6, 2026
Взгляды архитектора (дополнение к девяти)
Каждый — из дефекта, который нашла живая проверка за последние дни: это то, что ревью «по чистоте» обычно пропускает, а пользователь встречает первым.
Тихая потеря входа. Код принял то, что дал человек, и молча выбросил. Три дефекта за один день были ровно такими: поля
nameиworkbook_idиз--body-fileтерялись в чартах (feat(datalens): charts of the wizard, QL charts and charts of the editor are read and written (#352) #445) и датасетах (fix(datalens): datasets update and validate keep the fields a file or -F gives #453);nullв обязательных полях дашборда выбрасывался из запроса (feat(datalens): dashboards are read, created, saved and deleted (#352) #454). Агент ищет каждое место, где значение берётся «по ключу из слитого словаря», фильтруется поis not None, заменяется умолчанием или отбрасывается без ошибки, и для каждого отвечает: это намерение или потеря?Текст ошибки как интерфейс.
The request cannot be built: body: Input should be a valid dictionaryчеловеку ничего не говорит (было в feat(datalens): charts of the wizard, QL charts and charts of the editor are read and written (#352) #445). Для каждого места, где ycli сам отказывает: названо ли поле, сказано ли, что сделать, не утекает ли входное значение. И обратное: где ycli молчит, а отказать должен.Утверждения в описаниях без свидетельства. Описание инструмента — это обещание агенту. За неделю три оказались неверными: «значение строки приходит текстом», «без фильтра — запуски всех форм», «подключение Google Sheets создаётся через API». Агент выписывает каждое утверждение о поведении API в докстрингах, описаниях инструментов, справке команд и навыках и ставит рядом свидетельство — записанный ответ, контрактный случай по замеру, страницу справки — или пометку «свидетельства нет».
Проверки, которые не кусаются. Архитектурный тест, список исключений в нём, пометка
# violation(…)(их 65), контрактный случай, написанный по документу, а не по замеру. По каждой: видела ли она когда-нибудь дефект, который должна ловить; нужна ли пометка до сих пор; что она пропускает (тест «имя не от генератора» ловил суффиксModel, но неCHTABLE1).Рукописное, которое выводится из одного источника. На каждую операцию четыре файла, и большая часть
cli.pyиmcp.pyповторяет друг друга иclient.py: те же аргументы, те же описания, тот же вызов. Агент меряет, какая доля этих файлов механически следует изendpoints.pyи модели запроса, и что в них действительно написано рукой (описания, оговорки, порядок опций). Это кандидат на самое большое удаление кода в проекте — и ответ на вопрос, почему DataLens покрывается медленно. Только варианты, решение за владельцем.Публичная поверхность SDK. Что человек может импортировать и на что тем самым мы подписались: имена, попавшие в публичные случайно; один смысл под разными именами в разных сервисах (
get/get_by_id,list/list_global,page_id/id); что возвращает удаление (ничего,Ack, модель); где аргумент позиционный, а где только именованный. Таблица расхождений между сервисами.Путь секрета. От входа до провода и обратно: журнал, текст ошибки,
--dry-run,repr, дамп, записанные ответы, URL. Для каждого места, где печатается что-то пришедшее извне: может ли там оказаться секрет. После DataLens: строгие объединения в запросах отклоняют виды, которые сервис принимает (GSHEETS_V2) — оставить строго или пропускать? #444 и Секрет в ответе, выданный один раз (privateKey секрета встраивания DataLens): печатать, маскировать или писать в файл? #448 гарантия стала составной («для тела, подошедшего под свой вид», «секрет в ответе печатается») — проверить, что код делает именно то, что записано, и не больше.Цена запуска.
ycli --helpи старт MCP-сервера импортируют все сервисы; инструментов уже около четырёхсот. Что импортируется при запуске одной команды, сколько это занимает, какого размераtools/list. Не красота, но прямо влияет на то, каким продукт ощущается.Что удалить целиком. Не строки, а возможности: параметры, которые никто не передаёт; классы без пользователей (
BotTokenAuth,APIKeyAuth, debt: delete what nothing uses, and use what we already have instead of our own code #234); 135 файлов сfrom __future__ import annotations(debt: dropfrom __future__ import annotationseverywhere #320); команды, дублирующие друг друга (tracker_issues_listрядом сtracker_issues_search). Список кандидатов с доказательством, что пользователей нет.Пункты 10–13 и 16 — «исправить» (это дефекты). Пункты 14, 15, 17, 18 — только варианты на решение.
bim-ba commentedon Oct 6, 2026
К пункту 14 (владелец, 2026-10-06): направление — декларативное описание операции
Цепочка, как её назвал владелец и как она устроена в коде сейчас:
flowchart LR O[Операция: endpoints.py<br/>запрос, эффект, тип ответа] --> S[SDK: client.py<br/>метод отправляет операцию] S --> C[CLI: cli.py] S --> M[MCP: mcp.py] S --> X[другая поверхность,<br/>если появится]Операция — точка входа для SDK, SDK — точка входа для всех поверхностей. Сегодня каждая стрелка написана руками: метод клиента повторяет аргументы операции, команда и инструмент повторяют аргументы метода и его описание. Унификация здесь — одно декларативное описание операции, из которого поверхности выводятся, а не пишутся; то же описание — общий язык с refract.
Что сквозной агент по этой теме должен принести (только варианты, без правок):
client.py,cli.py,mcp.pyмеханически следует изendpoints.pyи модели запроса, и что написано рукой. Список рукописного по видам: тексты описаний, имена и короткие формы опций, поведение только CLI (--wait, слияние--body-fileи-F, подтверждение удаления, чтение файла), только MCP (OverBudget, аннотации), порядок аргументов.Effect→ аннотации инструментов; контрактные случаи с формами CLI, MCP и SDK; проверка DataLens: как RPC-операция выглядит в SDK, CLI и MCP — конверт или аргументы #371 «аргументы = поля запроса»;scripts/gen_openapi.py, который уже выводит OpenAPI из операций.OperationнадEndpointиRPC), то она же и есть это декларативное описание — два пункта решаются одним устройством или двумя?Итог — один issue
needs-decisionс вариантами устройства; решает владелец.bim-ba commentedon Oct 6, 2026
Находки к взгляду 9 (унификация), от E5 при исполнении #412; строки по main
bbced15a:-Fу четырёх команд Трекера.tracker issues update-bulk/move-bulk/transition-bulk(BulkValueOpt,src/ycli/yandex/tracker/issues/cli.py:276) иtracker entities update-bulk(BulkFieldOpt,src/ycli/yandex/tracker/entities/cli.py:72) объявляют собственную опцию--field/-F; глобальный-Fна них запрещён (OWN_FIELD,src/ycli/cli/inject.py:111-114). Разбор у них был другой (безa[b]и@file) — его выровнял feat(cli)!: -F key=@file reads a field's value from a file #472; сама отдельная опция осталась: она задаёт поле каждой задачи (уходит подvalues), а глобальная — поле запроса.tracker entities reports-create -F(src/ycli/yandex/tracker/entities/cli.py:365) — список имён колонок, а неkey=value.key=valueс простым разбором, не-F:tracker entities search --filter(entities/cli.py:210) иtracker issues scroll-clear --pair(issues/cli.py:253);--aclуpermissions-update(entities/cli.py:281) выровнен тем же feat(cli)!: -F key=@file reads a field's value from a file #472.bim-ba commentedon Oct 6, 2026
Находка к взгляду 11 (текст ошибки), от E5 и архитектора при приёмке #474; воспроизведено на main
798a6876прямой проверкой моделиCreateSparkApplicationArgs:datalens sparkapplications createбез вида даёт три строки видаCreateSparkApplicationArgsVariant1.sparkApplication: Field required; с двумя видами — пять строк, среди нихCreateSparkApplicationArgsVariant2.sparkApplication: Extra inputs are not permitted. Человеку нужно одно: «дай ровно один изsparkApplication,pysparkApplication,sparkConnectApplication». То же ждётhtmlpages updateи любой запрос, который документ пишет объединением объектов (refactor(datalens): a request given as a union of objects has an envelope per member #464). Это вопрос к тому, как CLI и MCP печатаютValidationErrorтакого объединения, а не к отдельной команде; в feat(datalens): a Spark application is made, of any of its three kinds (#352) #474 не правилось.bim-ba commentedon Oct 7, 2026
Находка к взглядам 9 (унификация) и 16 (путь секрета), от E5 при исполнении #477; main
a3e2130c:FastMCP(напрямую; защита отказа аргументов ставится в 5 из них. Серверов, которые можно импортировать и смонтировать у себя, три уровня: корневой (ycli.mcp.server.build_server), четыре сервисных (ycli.yandex.<сервис>.mcp.server.mcp) и серверы ресурсов (ycli.yandex.<сервис>.<ресурс>.mcp.mcp, около 95).ArgumentRefusals(отказ аргументов без повторения присланного, fix(mcp): a refusal of a tool's arguments no longer repeats what was sent #477) несут корневой и четыре сервисных; сервер одного ресурса, смонтированный кем-то сам, отвечает сырым текстом pydantic сinput_value. Закрыть всё — общий конструктор сервера ресурса (правка ~100 файлов, генераторnew_endpoint.py, архитектурный тест «сервер создан конструктором»); решение владельца: считать ли серверы ресурсов публичной поверхностью. Сейчас это сказано в докстрингах сервисных серверов и самогоArgumentRefusals.fix(datalens): a request that is one of several objects is refused on…
fix(datalens): a request that is one of several objects is refused on…
fix(datalens): a request that is one of several objects is refused on…
bim-ba commentedon Oct 7, 2026
Находка к взгляду 12 (пример, который сервис не примет), от E5; посчитано на main
4cb641ebпо контрактным случаям (tests/contract.load_cases) и записанным ответам (tests/fixtures/replies/<сервис>/<ресурс>/<метод>.json). Кода не меняла.У 74 из 261 записывающей операции нет ни одного записанного живого ответа — их контрактные случаи написаны по документу или по догадке, и тело из случая сервис мог ни разу не принять.
Где именно нет записи:
Границы подсчёта:
Case.expected_effect).dashboards create(случай слал тело безentry.meta) как раз из 74.bim-ba commentedon Oct 7, 2026
К моему счёту по взгляду 12 — два подтверждённых примера «случай по документу → сервис отвечает 400» (измерено вживую 2026-10-07 при записи #481; принятые тела — в
e2e/scenarios/datalens/entries_content.yaml):datalens.reports.create: случай шлётdata: {"slides": [{"id": "s1"}]}; DataLens на ровно это тело отвечает 400VALIDATION_ERRORи требуетdata.counter,data.salt,data.slideGroups,data.slidesOrder,data.visualSettings,data.slideSettings.datalens.dashboards.create: сервис требуетtabs[].connections,tabs[].aliases,settings.silentLoading,settings.expandTOC; в случае нет ни одного из четырёх (измерено на теле без тех же четырёх ключей, не на самом теле случая).После #481 у 19 записывающих операций DataLens из 42 запись появилась: без записанного ответа остаётся 55 из 261 (DataLens 23 из 71 — разделы по документу, #456).
bim-ba commentedon Oct 7, 2026
Дополнения к плану (владелец, 2026-10-07)
Когда. После движка «файлы в git» и двух первых видов (#490, вариант Б): ревью идёт от явного baseline, «как с чистого листа».
Ещё один агент в составе ревью — разведчик идей. Не ищет дефекты, а собирает мелкие улучшения и фичи: читает документацию зрелых инструментов того же рода (gh, kubectl, Terraform, AWS CLI, Stripe CLI, спецификация MCP, FastMCP) и сверяет с тем, что ycli умеет сегодня (по справке команд и коду, не по памяти). Возвращает таблицу: идея одной фразой с примером команды, у кого подсмотрено и ссылка, есть ли у нас что-то близкое (файл или текст справки), кому полезно, размер, достоверность. Предпочтение — тому, что выводится из уже объявленного (реестр операций, модели, метки) и ложится на все операции разом.
--yesв справке команды чтения).#234 и #320 (удалить неиспользуемое; убрать
from __future__ import annotations) — не раньше ревью: оно само допишет в техдолг, тогда и разберём вместе.bim-ba commentedon Oct 7, 2026
Находки до ревью (разведчик SDK, 2026-10-07; проверено с двух сторон, первая подтверждена чтением)
К взглядам «метки вместо строк» (#457) и «современные средства библиотек»:
ycli/yandex/models.py: «поле игнорируется API» распознаётся по строке-приставке"Ignored by the API: "в описании поля — нужна типизированная метка вAnnotated, какNoDropNull.ycli/yandex/errors.py: разбор тела ошибки — цепочкаisinstanceпо пяти формам; естьTypeAdapterнад объединением моделей тела (он же дал бы типизированный код ошибки).endpoints.pyресурсов (491 функция): параметры запроса — словари со строковыми ключами (params={"scrollTTLMillis": …}); есть модель параметров, сериализуемая тем же путёмWIRE, что тело.core/session.py:Retry-Afterв виде HTTP-даты не разбирается; в стандартной библиотеке естьemail.utils.parsedate_to_datetime.send— кандидат на вывод из описания операции (см. идею 40 в заходе 2).bim-ba commentedon Oct 7, 2026
Цифры к направлению «операция описана один раз» (карта слоёв, #503)
endpoints.py; руками вокруг него пишется 44–148 строк в пяти-шести файлах (клиент, CLI, MCP, случаи, модель).Ревью должно пройти по этим восьми повторам как по списку.
53 remaining items
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/src/ycli/yandex/core/session.py
вот тут как-будто бы очень усложнено и нарушаются SRP принципы, не проще например декомпозировать сессию на подмодули: sync, async, utils? почти 500 строк блин на эту штуку, неужели никак нельзя красиво это сделать? да и опять эти топ-левел функции меня встречают..
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/src/ycli/yandex/sync
блин, мне не нравится что типа у нас в yandex модуле лежит подмодуль sync
ну это же по идее независимая от yandex штука? это просто правильное i/o разных документов и моделей? почему он лежит именно там? мы в этом уверены?
и кстати все то же самое с status
вот типа смотри у нас в яндексе лежит: ядро, 4 сервиса, статус, синк
это точно нормальная история? так делают?
bim-ba commentedon Oct 9, 2026
ycli/src/ycli/mcp/cli.py
Lines 79 to 104 in 7d2dbd3
блин, где-то у нас это лежит в typedefs.py, где то вот так вверху модуля, в чем система и стандарт? почему бы cli не разделять например на: commands, typedefs, models, итд... и то же самое делать и с mcp например?
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/src/ycli/mcp/http_auth.py
что это вообще тут делает? это же уровень транспорта, то есть ядра?
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/src/ycli/cli/api_response.py
опять же почему это вообще тут а не на уровне ядра? я не понимаю?
bim-ba commentedon Oct 9, 2026
у нас в ycli.cli и ycli.mcp как будто очень много лишней фигни, которой могло бы не быть если бы мы просто правильно все разделили архитектурно по слоям? типа многое из cli и mcp можно вынести именно в ядро. в yandex оставить только то что релевантно яндексу. само ядро вынести в ycli.core (еще раз, оно должно быть генерализированным, универсальным и унифицированным). а сейчас мне кажется у нас вообще очень много слоев между собой смешалось и это все нереально читать теперь и поддерживать. да и стандартов как-будто никаких вообще нету для кода. а кодстандарты и best-practices мы бы могли сделать если бы у нас было много хороших ast-grep правил ведь
bim-ba commentedon Oct 9, 2026
кстати, мне кажется сложность кода и его качество тоже можно было бы замерять через ast-grep? нам нужно просто определиться именно с правилами, скорами, системностью и стандартами, верно? можно например те же нейминги сюда же внести мне кажется. это же очень полезная штука, которая не только людей будет направлять, но и агентов наших, а то сейчас это все получается большими мазками поверх несистемности и без стандартов каких-то
bim-ba commentedon Oct 9, 2026
и причем все это относится еще и к документации, e2e, скриптам, тестам и так далее
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/smoke_test.py
нахера эта штука вообще нужна тут?
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/conftest.py
это нам же по стандарту pytest нужно?
bim-ba commentedon Oct 9, 2026
https://github.com/bim-ba/ycli/blob/7d2dbd30bfe401e0b1fff719604614fff11d3034/pyproject.toml
вот в этом файлике нету какого-то легаси и так далее? все норм?
bim-ba commentedon Oct 10, 2026
Решено (владелец, 2026-10-10): как проводить — три слоя, инструменты как подсказки
Дополняет раздел «Как проводить» выше; план целиком перепишу, когда разберу комментарии владельца от 9 октября.
файл:строкаПравила:
Инструменты слоя 1 (запущены на
src, main7d2dbd30): pyscn 1.32.4, ruff с выключенными у нас правиламиC901иPLR09xx, wemake-python-styleguide, skylos 4.47.2, vulture 2.16, complexipy 8.0.1, graphify, наши ast-grep и import-linter. Свои правила пишем в ast-grep: pyscn расширяется только порогами и слоями. semgrep и CodeQL не берём — второй движок правил ради того же.Первый замер:
Визуализация: отчёт pyscn и граф graphify как есть; плюс проба CodeCharta с нашими метриками и находками агентов с лимитом полчаса, а если не взлетит — своя страница.
bim-ba commentedon Oct 10, 2026
В план ревью (решено владельцем в #562, 2026-10-10): каждый агент области отвечает по каждой операции, где и сколько раз записан её список параметров (описание, метод SDK, команда, инструмент) и собирается ли тело руками в команде. Замер до чтения: 319 функций с более чем пятью аргументами, 166 операций; у 35 список записан в четырёх слоях, у 126 — длинный только у команды или инструмента. Карта идёт в #508, где решается «плоско или объектом».
[-]Техдолг: полное ревью кода на clean code и красоту — параллельные субагенты по областям, проверяющий поверх[/-][+]Техдолг: стандарт кода, карта слоёв и ответы на 58 замечаний — ревью всего кода параллельными агентами[/+]bim-ba commentedon Oct 10, 2026
Правила работы, выведенные 10–11 октября (кандидаты в
docs/conventions/delivery.md)Каждое стоило круга работы; записаны здесь, чтобы пережить сжатие сессий. В репозиторий пойдут отдельным PR после слова владельца.
origin/main-o nameбыл зелёным при неработающем отказе: лазейка пропускала 312 случаев/tmp; рабочие копии — вне/tmp, коммит по ходу/tmptests--match-head-commit), после слияния сверять дерево main с деревом этой головыpkill -f <имя скрипта>убивает и оболочку, которая его запустила--tool-search; #576: сломанные ссылки в 154 схемах — всё при зелёном наборе тестов