Repository navigation
Open
0 / 70 of 7 issues completedLabels
priority:nowDo nowDo nowwayfinder:mapWayfinder map: the route to one destinationWayfinder map: the route to one destination
Description
Карта ведет к окончательной архитектуре ycli и refract. Вопросы к тебе - подзадачи этой карты, ответы - в них самих.
Пункт назначения
Утвержденная и записанная архитектура: как одно описание операции превращается в SDK, CLI и MCP на нескольких языках и для чужих API, а не только для Python и Яндекса. На выходе ADR, глоссарий и спецификация, по которым можно планировать сборку. Код в рамках карты не меняется.
Заметки
- вопросы, примеры и места, где нужен твой взгляд, я публикую только в issue этой карты (твое решение от 19.11)
- решение проверяется на матрице «язык × API», одного Python и Яндекса мало
- сессии по карте опираются на навыки grilling, domain-modeling, codebase-design, showing-the-owner и researching-rigorously
- исходные материалы:
- ревью 18.11, четыре волны с проверяющими;
- реестр 73 решений из чата 12–14.10, он в первом комментарии;
- архив
ycli-research-2026-11-10.tar.zst: спецификация v1.3, брифы, kit13 и kit14
Решения
- 14.10, в чате. Описания операций пишутся на Python. Из них собирается OpenAPI 3.1 с ключами
x-ycli-*. refract, написанный на Python, генерирует по нему код на рукописном ядре каждого языка, и сгенерированное лежит в git. Это отменяет решение Вывод SDK, CLI и MCP из описания операции: итог исследования и пять решений до пробы #508 1-А о выводе во время работы. Подтверждение ждет бенчмарка. - 19.11. Ядро не вводит свои типы ошибок поверх неправильной логики чужого API. Такие причуды делаются через точку расширения refract.
- 19.11. Секреты по именам полей не маскируем, сложных обходов ради маски не делаем.
- 19.11. Метки
needs:,scope:,priority:,type:иwayfinder:(PR ci: manage issue labels from .github/labels.yml #601). - 19.11. Доверенный издатель на PyPI настроен - по твоим словам, я этого не проверял.
Еще не уточнено
- форма описания операции: декоратор, данные или вывод из сигнатуры. Станет ясно после бенчмарка
- где живут спецификация и ядра других языков: в refract или в отдельных репозиториях
- как refract проверяет сгенерированный код на чужих API. В старом refract это делали стратегии
- гибридный MCP по умолчанию. Нужен прогон на настоящей модели
Вне рамок
- механические правки из ревью (e2e, gitleaks, токен OAuth): они идут отдельными PR, это не решения карты
- безопасность - в своих issue План запроса печатает секрет: маска знает имя поля, а не значение #597–Релиз: кто может опубликовать и что поймает сканер #600
Metadata
Metadata
Assignees
Labels
priority:nowDo nowDo nowwayfinder:mapWayfinder map: the route to one destinationWayfinder map: the route to one destination
Activity
bim-ba commentedon Nov 18, 2026
Реестр твоих решений из этого чата за 12-14.10: 73 решения, из них 66 окончательных. Ни одно из них не записано ни в репозиторий, ни в issue. Ниже - все, сгруппированные по теме. Смысл решения написан по-английски, как в будущем ADR, а рядом твои слова. Перекрытые решения перечеркнуты.
review-process
repo-hygiene
research-method
research-scope
issue-format
test-org
security-ci
testing-scope
product-goal
refract-scope
catalogue
x-ycli-*? типа прям там в спеке указывать метаданные какие-то, мы же можем делать extend этой спецификации»procedures
core
deliverable
authoring-style
surfaces
compat
source-of-truth
mcp
load_always=True»cli
C70 Nested CLI objects: lean to one option with k=v shorthand or JSON (C), pending implementation cost.(заменено C71)sdk
C39 A request body with more than three fields becomes one model (39 operations change).(заменено C46)mcp-safety
C42 Where the client cannot ask a person, confirm a destructive call with a second call carrying a token.(заменено C50)config
cli-output
mcp-output
C49 MCP text part is a short table and the structured part the full data, with the shown fields declared as metadata without tight coupling.(заменено C59)sdk-null
standing-asks
generation
java
C62 Java passes body fields through a lambda that fills a builder (AWS SDK v2 style).(заменено C63)refract-lang
uvx… rust хорош… но нужно мерить»C65 Maybe refract could be in Rust after all, pending distribution, OS support and library quality.(заменено C67)mcp-metadata
quality