#!/usr/bin/env bash
# Вход для архитектурного прохода ревью: то, чего нет в диффе.
#
# Агент, видящий только `git diff`, физически не может судить об архитектуре —
# он не знает, какие понятия в проекте уже есть и как они называются. Скрипт
# собирает дерево пакетов с назначением, публичную поверхность, граф внутренних
# зависимостей и инвентарь существующих концепций.
#
# Использование: scripts/review-context.sh [> tmp/review-context.md]

set -eu

MOD="$(awk '/^module /{print $2}' go.mod)"
PKGS="$(go list ./... | grep -v '/migrations$')"

echo "# Контекст проекта для архитектурного ревью"
echo
echo "Сгенерировано \`scripts/review-context.sh\`. Модуль: \`$MOD\`."
echo

echo "## Пакеты и назначение"
echo
echo '```'
go list -f '{{.ImportPath}}|{{.Doc}}' ./... | sed "s|^$MOD/||" |
  awk -F'|' '{printf "%-34s %s\n", $1, ($2 == "" ? "— (нет doc-комментария пакета)" : $2)}'
echo '```'
echo

echo "## Граф внутренних зависимостей"
echo
echo "Только импорты внутри модуля. Стрелка A -> B означает «A зависит от B»."
echo
echo '```'
for p in $PKGS; do
  deps="$(go list -f '{{range .Imports}}{{.}}
{{end}}' "$p" | grep "^$MOD/" | sed "s|^$MOD/||" | sort -u | tr '\n' ' ')"
  [ -n "$deps" ] && echo "${p#"$MOD"/} -> $deps"
done
echo '```'
echo

echo "## Публичная поверхность пакетов"
echo
echo "Экспортированные типы, интерфейсы и функции — то, чем пакеты договариваются."
echo
for p in $PKGS; do
  short="${p#"$MOD"/}"
  body="$(go doc -short "$p" 2>/dev/null | grep -v '^$' || true)"
  [ -z "$body" ] && continue
  echo "### $short"
  echo '```go'
  echo "$body"
  echo '```'
  echo
done

echo "## Инвентарь концепций"
echo
echo "Как в проекте уже называются вещи. Новое понятие вводим, только убедившись,"
echo "что его нельзя выразить существующими."
echo
echo "### Доменные ошибки (sentinel)"
echo '```'
grep -rhn "^var Err[A-Za-z]* = errors.New" --include='*.go' internal/ |
  sed 's/^[0-9]*://' | sort -u
echo '```'
echo
echo "### Состояния загрузки"
echo '```'
grep -rh "State[A-Za-z]* *State *= " --include='*.go' internal/store/ | sed 's/^\s*//' | sort -u
echo '```'
echo
echo "### Секции конфигурации"
echo '```'
grep -rh 'toml:"' --include='*.go' internal/config/ | sed 's/^\s*//' | sort -u
echo '```'
echo
echo "### Публичные команды воркера (вызываются транспортами)"
echo '```'
grep -rhn "^func (w \*Worker) [A-Z]" --include='*.go' internal/worker/ | sed 's/^[0-9]*://' | sort -u
echo '```'
echo
echo "### Capabilities OpenSpec"
echo '```'
ls openspec/specs/
echo '```'