Merge pull request #26 from Gfermoto/dev

fix: github-bootstrap-project — диагностика и вход с project scope

Author: Gfermoto

CONTRIBUTING.md

@@ -64,9 +64,10 @@ Look for issues labelled **`good first issue`** — small, scoped tasks for newc
 
 **Issues**, **Discussions**, and **Projects** are enabled on the repo. Labels `area:*`, `priority:*`, and `triage` support triage; milestones **v0.2.3** and **Backlog (no milestone)** are available.
 
-To create the Kanban project **BirdLense Hub — Roadmap** and link this repository (requires GitHub CLI with `project` scope):
+To create the Kanban project **BirdLense Hub — Roadmap** and link this repository, GitHub CLI needs **Projects** scopes. If `gh auth refresh -s project -s read:project` does nothing, do a full login (or use a **classic** PAT with the `project` scope as `GH_TOKEN` — see script header):
 
 ```bash
-gh auth refresh -s project -s read:project
+gh auth logout -h github.com
+gh auth login -h github.com -w -s repo -s read:org -s gist -s project -s read:project
 bash scripts/github-bootstrap-project.sh
 ```

CONTRIBUTING.ru.md

@@ -64,9 +64,10 @@ make start
 
 В репозитории включены **Issues**, **Discussions** и **Projects**. Метки `area:*`, `priority:*`, `triage` и вехи **v0.2.3** / **Backlog (no milestone)** уже заведены.
 
-Создать проект **BirdLense Hub — Roadmap**, привязать репозиторий и поле «Поток» (канбан):
+Создать проект **BirdLense Hub — Roadmap**, привязать репозиторий и поле «Поток» (канбан). Нужны права **Projects** у токена gh. Если `gh auth refresh` не помогает — полный вход или classic PAT с scope `project` (см. комментарии в `scripts/github-bootstrap-project.sh`):
 
 ```bash
-gh auth refresh -s project -s read:project
+gh auth logout -h github.com
+gh auth login -h github.com -w -s repo -s read:org -s gist -s project -s read:project
 bash scripts/github-bootstrap-project.sh
 ```

scripts/github-bootstrap-project.sh

@@ -1,21 +1,56 @@
 #!/usr/bin/env bash
 # Создаёт GitHub Project (v2) у владельца, линкует репозиторий BirdLense-Hub,
-# добавляет поле «Поток» (Backlog → … → Done) поверх стандартного Status.
+# добавляет поле «Поток» (Backlog → … → Done).
 #
-# Требуется один раз расширить gh-токен:
-#   gh auth refresh -s project -s read:project
+# Аутентификация (любой рабочий вариант):
+#
+#   A) OAuth через браузер с нужными scope (надёжнее, чем только refresh):
+#        gh auth logout -h github.com
+#        gh auth login -h github.com -w -s repo -s read:org -s gist -s project -s read:project
+#
+#   B) Классический PAT: https://github.com/settings/tokens/new
+#      Включите scope «project» (и «repo», «read:org» как минимум).
+#        export GH_TOKEN=ghp_xxxxxxxx
+#        bash scripts/github-bootstrap-project.sh
+#
+#   Вариант «refresh» часто НЕ добавляет project, если токен fine-grained или кэш не обновился.
 #
 set -euo pipefail
 
 OWNER="${GITHUB_PROJECT_OWNER:-Gfermoto}"
 REPO_FULL="${GITHUB_REPO:-Gfermoto/BirdLense-Hub}"
 PROJECT_TITLE="${GITHUB_PROJECT_TITLE:-BirdLense Hub — Roadmap}"
 
-if ! gh project list --owner "$OWNER" --limit 1 >/dev/null 2>&1; then
-  echo "gh не может читать Projects (нужны scope project / read:project). Выполните:"
-  echo "  gh auth refresh -s project -s read:project"
-  echo "Затем снова запустите этот скрипт."
+die_help() {
+  echo ""
+  echo "=== Что сделать ==="
+  echo "1) Посмотрите scopes:  gh auth status"
+  echo "   Нужны в списке: project и read:project (или один classic PAT с правом Projects)."
+  echo ""
+  echo "2) Надёжно: полный вход с scope:"
+  echo "     gh auth logout -h github.com"
+  echo "     gh auth login -h github.com -w -s repo -s read:org -s gist -s project -s read:project"
+  echo ""
+  echo "3) Или classic PAT в переменную (не коммитьте!):"
+  echo "     export GH_TOKEN=ghp_..."
+  echo "     bash scripts/github-bootstrap-project.sh"
+  echo ""
   exit 1
+}
+
+TMPERR=$(mktemp)
+trap 'rm -f "$TMPERR"' EXIT
+
+if ! gh project list --owner "$OWNER" --limit 1 2>"$TMPERR"; then
+  echo "Ошибка при gh project list:"
+  sed 's/^/  /' "$TMPERR"
+  echo ""
+  if [[ -n "${GH_TOKEN:-}" ]]; then
+    echo "Используется GH_TOKEN: убедитесь, что это классический PAT со scope «project» (fine-grained с ограничением только на репо Projects может не подойти)."
+  else
+    echo "Токен gh, скорее всего, без scope Projects. «gh auth refresh» иногда не меняет права (fine-grained / старый OAuth)."
+  fi
+  die_help
 fi
 
 exists_json=$(gh project list --owner "$OWNER" --format json --limit 50)
@@ -33,8 +68,7 @@ fi
 echo "Линкую $REPO_FULL…"
 gh project link "$proj_num" --owner "$OWNER" --repo "$REPO_FULL" 2>/dev/null || true
 
-# Доп. поле для канбана (рядом со стандартным полем Status в Projects)
-echo "Добавляю поле «Поток» (если ещё нет — при дубликате будет ошибка, её можно игнорировать)…"
+echo "Добавляю поле «Поток» (если ещё нет — при дубликате можно игнорировать)…"
 gh project field-create "$proj_num" --owner "$OWNER" \
   --name "Поток" \
   --data-type "SINGLE_SELECT" \