feature: OSA CI/CD mode

[Shtirmann]

Изменения в PR:

CI/CD:

• Добавлен файл action.yml. Теперь OSA - это Composite Action. OSA можно подключить к любому репозиторию одной строчкой в workflow. Он сам поставит зависимости и запустит анализ. При каждом коммите в ветке - дополняет новые функции, в которых нет док-стрингов.
• Добавлен флаг --incremental - в нём OSA не переписывает весь проект, а только заполняет пустые докстринги, которых не хватает.
• Добавлен флаг --target-files - позволяет передать список файлов для анализа. В контексте Actions позволяет передавать только те файлы, которые изменились, а не весь репозиторий.
• В run.py добавлена проверка на GITHUB_ACTIONS, если OSA видит что она в CI режиме, то она автоматически работает с текущей веткой PR, а не стандартной osa_tool (чтобы не возникло конфликтов).

Багфиксы:

• Юнит тесты проверяли, что код НЕ меняется, хотя должен был? Дополнил юнит тесты на корректную логику.
• Раньше рекурсивные функции (вызывающие сами себя) создавали циклическую зависимость в графе и просто игнорировались. Теперь саморекурсия игнорируется.
• Починил баг с вставкой кода, когда из-за разницы переносов строк (\n в Linux и \r\n в Windows) OSA не могла найти место для вставки и отдавала пустой результат.
• Почему-то поиск через регулярки порой просто не находил функцию + не находились функции, если в конце объявления был комментарий.

Пример вызова в workflow:

- name: Run OSA Action
  uses: aimclub/OSA@main # Или @feature/ci_cd_mode пока не замержено
  with:
    openai_api_key: ${{ secrets.OPENAI_API_KEY }}
    api: 'openai'
    base_url: 'https://openrouter.ai/api/v1'
    model: 'openai/gpt-4o'

Для работы нужно добавить в Secrets репозитория токен провайдера, поддерживает всех из которых поддерживает OSA. Но если будем добавлять провайдеров - нужно будет дополнять логику.

Пайплайн работы представлен в комменте внизу.

[Shtirmann]

Пайплайн работы:

1. Делаем PR (видно что нет докстринга)

2. OSA начинает работу

3. OSA делает коммит

4. В коммите видем докстринги

Alt.

Если в PR у всех функций есть док стринги, то OSA не будет ничего делать.

Проект на котором тестил:
https://github.com/Shtirmann/lir-agent

[DRMPN]

1. Не смог запустить.

Ошибка - https://github.com/DRMPN/osa-streamlit/actions/runs/22584664537
Файл с action - https://github.com/DRMPN/osa-streamlit/blob/main/.github/workflows/osa.yml

2. В best practices советуют создать отдельный репозиторий под action.

Предлагаю пока оттестировать как есть, а перед влитием ПР сделать отдельный репозиторий и разместить action там.

3. Этот action можно будет опубликовать в GitHub Marketplace.

@nicl-nno что думаешь по этому поводу? В теории, может дать какой-то прирост пользователей и небольшую популярность.

4. Помню, что были проблемы с поиском/форматированием докстрингов, вероятно этот ПР решает большую их часть. У нас где-то зафиксированы проблемы с ними?

[Shtirmann]

Поправил, кажется, не запускалось, т.к. рассчитано на запуск только в контексте PR - теперь запускается и в push и в merge.

[DRMPN]

Проверил на push и pull request, все работает.

[DRMPN]

Вот кстати захардкоженное значение osa_tool.

[DRMPN]

Вот кстати захардкоженное значение osa_tool.