описание репозитория в Forgejo рекламирует rev: v0.1.0 вместо актуального тега #18

Closed
opened 2026-08-27 12:00:48 +07:00 by claude-secretary · 1 comment

Что не так

Поле description репозитория senokosov/pre-commit-hooks содержит инструкцию по подключению с устаревшим тегом:

Общие pre-commit hooks для всех монорепо volody (mcp, baton). check-file-length + check-model-comments. Подключение: repo: https://git.homedevlab.ru/senokosov/pre-commit-hooks, rev: v0.1.0

Актуальный тег — v0.13.0. Между v0.1.0 и v0.13.0 14 релизов, среди них ломающие: с v0.11.0 формат TODO(#N) строгий (префикс TODO(ns/proj#N) больше не принимается), плюс новые fail-условия в v0.4.0/v0.7.0/v0.9.0. Кто подключится по описанию, получит поведение полуторагодовалой давности.

Описание также перечисляет два хука (check-file-length, check-model-comments), а в .pre-commit-hooks.yaml их сейчас четыре: добавились no-agent-rules-in-code и todo-needs-issue.

README.md при этом корректен — в примере на строке 206 стоит rev: v0.13.0. Расходится только description репозитория.

Почему это стало заметно

2026-08-27 организация senokosov переведена в visibility: public, чтобы GitLab-проекты могли тянуть хуки анонимно, без деплой-токенов. Репозиторий и его описание теперь видны неаутентифицированным пользователям, в том числе из интернета — устаревшая инструкция стала публичной.

Что сделать

  1. Обновить description репозитория: либо поднять тег до актуального, либо убрать rev: из описания совсем и отправлять за примером в README.md — тогда оно не будет протухать при каждом релизе.
  2. Там же поправить перечень хуков (сейчас их четыре).
  3. Если решение — держать тег в описании, добавить шаг «обновить description» в релизную процедуру, иначе разойдётся снова на следующем бампе.

Вариант 1-без-тега выглядит устойчивее: одно место правды (README.md), описание не требует синхронизации.

## Что не так Поле description репозитория [senokosov/pre-commit-hooks](https://git.homedevlab.ru/senokosov/pre-commit-hooks) содержит инструкцию по подключению с устаревшим тегом: > Общие pre-commit hooks для всех монорепо volody (mcp, baton). check-file-length + check-model-comments. Подключение: repo: https://git.homedevlab.ru/senokosov/pre-commit-hooks, rev: v0.1.0 Актуальный тег — `v0.13.0`. Между `v0.1.0` и `v0.13.0` 14 релизов, среди них ломающие: с `v0.11.0` формат `TODO(#N)` строгий (префикс `TODO(ns/proj#N)` больше не принимается), плюс новые fail-условия в `v0.4.0`/`v0.7.0`/`v0.9.0`. Кто подключится по описанию, получит поведение полуторагодовалой давности. Описание также перечисляет два хука (`check-file-length`, `check-model-comments`), а в `.pre-commit-hooks.yaml` их сейчас четыре: добавились `no-agent-rules-in-code` и `todo-needs-issue`. `README.md` при этом корректен — в примере на строке 206 стоит `rev: v0.13.0`. Расходится только description репозитория. ## Почему это стало заметно 2026-08-27 организация `senokosov` переведена в `visibility: public`, чтобы GitLab-проекты могли тянуть хуки анонимно, без деплой-токенов. Репозиторий и его описание теперь видны неаутентифицированным пользователям, в том числе из интернета — устаревшая инструкция стала публичной. ## Что сделать 1. Обновить description репозитория: либо поднять тег до актуального, либо убрать `rev:` из описания совсем и отправлять за примером в `README.md` — тогда оно не будет протухать при каждом релизе. 2. Там же поправить перечень хуков (сейчас их четыре). 3. Если решение — держать тег в описании, добавить шаг «обновить description» в релизную процедуру, иначе разойдётся снова на следующем бампе. Вариант 1-без-тега выглядит устойчивее: одно место правды (`README.md`), описание не требует синхронизации.
Author
Owner

Подтверждаю по API — описание сейчас такое:

Общие pre-commit hooks для всех монорепо volody (mcp, baton). check-file-length + check-model-comments. Подключение: repo: https://git.homedevlab.ru/senokosov/pre-commit-hooks, rev: v0.1.0

Расхождение с тех пор выросло: актуальный тег — v0.21.0 (все теги v0.10.0v0.21.0 проставлены сегодня, #16), а хуков в манифесте 14, не два.

Сделать сам не могу: в MCP-слое Forgejo нет метода правки метаданных репозитория (PATCH /repos/{owner}/{repo} не зеркалится) — только файлы, issues, PR и Actions. Нужен UI или прямой вызов API.

Предлагаю вариант «без тега» — одно место правды, описание не протухает при каждом релизе:

Общие pre-commit hooks для монорепо volody: длина файлов, запреты приватных импортов и вызовов, ссылок на задачи и tracking-меток в комментариях, битых path-ссылок, broad except, длинных имён модулей, ссылок на этапы плана. Готовый consumer-конфиг и актуальный rev — в README.

Если предпочтительнее оставить тег в описании — тогда третий пункт задачи обязателен: шаг «обновить description» в релизной процедуре, иначе разойдётся снова на следующем бампе. Ту же роль может сыграть проверка из #28, если расширить её на description.

Оставляю задачу открытой — за вами одно движение в настройках репозитория.

Подтверждаю по API — описание сейчас такое: > Общие pre-commit hooks для всех монорепо volody (mcp, baton). check-file-length + check-model-comments. Подключение: repo: https://git.homedevlab.ru/senokosov/pre-commit-hooks, rev: v0.1.0 Расхождение с тех пор выросло: актуальный тег — `v0.21.0` (все теги `v0.10.0`–`v0.21.0` проставлены сегодня, [#16](https://git.homedevlab.ru/senokosov/pre-commit-hooks/issues/16)), а хуков в манифесте **14**, не два. **Сделать сам не могу:** в MCP-слое Forgejo нет метода правки метаданных репозитория (`PATCH /repos/{owner}/{repo}` не зеркалится) — только файлы, issues, PR и Actions. Нужен UI или прямой вызов API. Предлагаю вариант «без тега» — одно место правды, описание не протухает при каждом релизе: ``` Общие pre-commit hooks для монорепо volody: длина файлов, запреты приватных импортов и вызовов, ссылок на задачи и tracking-меток в комментариях, битых path-ссылок, broad except, длинных имён модулей, ссылок на этапы плана. Готовый consumer-конфиг и актуальный rev — в README. ``` Если предпочтительнее оставить тег в описании — тогда третий пункт задачи обязателен: шаг «обновить description» в релизной процедуре, иначе разойдётся снова на следующем бампе. Ту же роль может сыграть проверка из [#28](https://git.homedevlab.ru/senokosov/pre-commit-hooks/issues/28), если расширить её на description. Оставляю задачу открытой — за вами одно движение в настройках репозитория.
Sign in to join this conversation.
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
senokosov/pre-commit-hooks#18
No description provided.