Skip to content

Утвердить архитектуру 14.10 как окончательную #604

Open

Description

@bim-ba

Окончательная архитектура сегодня записана только в чате. ARCHITECTURE.md и design.md в refract описывают другую систему, поэтому каждый новый агент строит по старой.

Вопрос

Утвердить архитектуру 14.10 как окончательную и записать ее как ADR вместо #508 1-А? Решать после бенчмарка «язык × API» - он блокирует этот тикет.

Что ты решил 14.10 в чате

решение твои слова
описания операций пишутся на Python, OpenAPI можно и импортировать, и экспортировать «наша архитектура может и импортировать и экспортировать OpenAPI спеку расширенную»
Python SDK генерируется так же, как остальные языки «наверное хорошая идея, мне нравится»
каталог - OpenAPI 3.1 плюс x-ycli-*, своего формата нет «вроде выглядит норм»
сгенерированный код лежит в git, ручные правки - в _patch.py «лучше хранить генерацию в гите»
чужой API = его OpenAPI плюс x-ycli-*, остальное пишется руками на ядре «остальное описывайте будьте добры руками через наше ядро»
у каждого языка свое рукописное ядро, сгенерированный код - тонкий слой над ним «мы пишем ядро на каждом языке со всеми нужными абстракциями»
flowchart LR
  subgraph now["Сейчас в документах"]
    a1["ycli: client/cli/mcp руками"] --> b1["refract: YAML → копия ycli байт в байт"]
  end
  subgraph rec["Решено 14.10"]
    a2["описания на Python"] --> c2["OpenAPI 3.1 + x-ycli-*"] --> d2["refract"] --> e2["SDK, CLI, MCP на 5 языках поверх ядра"]
  end
Loading

Что поменяется, если «да»

Рекомендую: да, если бенчмарк не покажет, что вывод во время работы дает меньше ручного кода на Python и TypeScript больше чем на порог, который ты задашь.
Против: сгенерированный Python SDK - это тысячи строк в git и отдельная проверка расхождений, а вывод во время работы обходится без них.

Ответ одной строкой: «да» или «нет, потому что…».

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs:decisionWaiting for an owner decisionpriority:nextDo after the current workwayfinder:grillingWayfinder ticket: a decision settled in conversation with the owner

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions