Документация

Версии проекта: сохранить, выложить, применить

Каждый шаг делает человек: сохранить версию своим описанием, выложить копию наружу, применить работу в проект одной кнопкой — и отменить, если передумали.

VibeForge не прячет git за одной кнопкой «применить». Процесс разложен на шаги, и каждый делает человек:

индекс → коммит своим сообщением → push ветки → pull request → слияние

Что где нажимается

Шаг	Где
Stage all / Unstage all / Discard, «+» и «−» у файла	Список «Изменений»
Сообщение, описание, кнопка Commit (и Commit + Push в её меню)	Низ «Изменений»
Push со счётчиком неотправленных коммитов	Ряд действий внизу колонки
Pull request и Merge → main	Там же
Отменить (revert)	Карточка итога под рядом действий и вкладка «История»

Здесь стоят настоящие имена операций — Commit, Push, Pull request, Merge, Staged / Unstaged / Committed. Пересказ вроде «применить в проект» жил бы своей жизнью и не совпадал ни с git log, ни с GitHub, ни с любой инструкцией в интернете. Зато у каждой кнопки есть подсказка с последствием: подсказка Push начинается с git push -u origin, а у «Отменить» — с «git revert коммита слияния».

Что делает Merge → main

Одна зелёная кнопка проходит весь путь до основной ветки, и каждый шаг виден полоской в ленте:

Commit — всё несохранённое уходит в коммит с подсказкой заголовка от агента.
Merge из основной — подтягивается свежая основная версия; если те же файлы правились с двух сторон, расхождения сводит воркер этой же сессии, он свою сторону правок помнит. После автослияния он же сверяет результат по смыслу и чинит то, что не сходится.
Merge в основную — ветка сессии вливается в основную.
Push — если у проекта есть origin. Единственный стоп: если в изменениях похоже на ключ или пароль, публикация откладывается, и об этом честно пишется в ленте.
Удаление ветки сессии.

Сорваться конвейер может на любом шаге; тогда видно, на каком именно, и проект остаётся ровно таким, каким был. В меню кнопки есть «Merge локально» — слить только на этом компьютере, а на GitHub отправить потом кнопкой Push; выбор запоминается. Если pull request влили прямо на github.com, приложение это заметит само: вместо Merge появится «Подтянуть основную».

Сразу после применения в ленте и в «Истории» есть «Отменить»: основная версия возвращается к состоянию до применения новым коммитом-откатом. История не переписывается, поэтому передумать можно ещё раз — просто примените снова.

Pull request вместо слияния

Для командных репозиториев с обязательным ревью: кнопка «Pull request» отправляет ветку сессии наружу и открывает PR, ссылка появляется под кнопкой и в ленте. Повторное нажатие обновляет уже открытый PR, а не плодит второй. Нужен вход в GitHub — кнопкой «Войти через GitHub» или токеном в «Настройки → GitHub», либо GitHub CLI с gh auth login. Если origin проекта в GitLab и он подключён в «Интеграциях», та же кнопка называется «Merge request» и открывает MR через API GitLab — см. «Старт из задачи».

История версий

Лента по дням («Сегодня», «Вчера») показывает каждую версию человеческим языком: кто создал (Вы, Агент, Авто, Автоочередь), что изменилось по файлам.
«Вернуться к коммиту» возвращает проект к любому состоянию новым коммитом — обратимо; «стереть коммиты новее» — с двойным подтверждением.
«Отложенное» — работа мимо основной линии: отклонённые изменения, эпики, незавершённые и отложенные автоочередью задачи. Вернуть в проект или удалить.
«Граф» — те же данные глазами git: все ветки и слияния.

Правила, которые экономят нервы

Индекс пуст — коммитим всё дерево (как git commit -a), и кнопка прямо об этом пишет: «Commit · все 5» против «Commit · 2 из индекса».
Разрушительное спрашивает второй раз на месте: Discard раскрывается в «Точно? / Нет» прямо в заголовке.
Пока сессия работает, индекс недоступен: агент пишет в то же дерево, и правка индекса из второго процесса — это гонка за index.lock.
Если действие недоступно, под ним написана причина текстом, а не только в подсказке.