Troubleshooting

Большинство проблем связано с local git hooks, отсутствующими git notes или настройками GitHub Pages.

Быстрые проверки

1. Проверьте local setup.

   npx agent-note status

2. Проверьте note у commit.

   npx agent-note show

3. Проверьте remote notes.

   git fetch origin refs/notes/agentnote:refs/notes/agentnote
   git notes --ref=agentnote show HEAD

Начните с симптома

Симптом	С чего начать
PR Report пустой	Проверьте, что notes были pushed и workflow получает полную git history
Ожидаемый prompt не отображается	Сравните compact и full
Dashboard открывается, но у PR нет данных	Проверьте, опубликованы ли notes этой PR
git commit не создает note	Запустите init снова и проверьте строку git: в status
Line Estimate не отображается	Проверьте, может ли agent предоставить достаточно доказательств редактирования

PR Report пустой

• PR branch был pushed после включения Agent Note.
• refs/notes/agentnote существует на remote.
• actions/checkout использует fetch-depth: 0.
• PR содержит commits с файлами, которые изменял agent.

Agent Note не пишет note для commits, где не найдено committed file, изменённое agent.

Если header показывает Total AI Ratio: — и Agent Note data: No tracked commits, значит в PR есть commits, но для них не найдены Agent Note data. Это не то же самое, что настоящий AI Ratio 0%.

Не хватает prompts

Prompt selection использует commit-to-commit window, а не всю session.

• compact показывает prompts, которые объясняют commit, и сохраняет отчёт читаемым.
• full показывает все сохраненные prompts.
• Старые task prompts опускаются, когда у текущего commit уже есть собственное объяснение.
• 📝 Context появляется для коротких prompts, когда имя файла или code identifier помогает понять контекст.

with:
  prompt_detail: full

Dashboard без данных

• GitHub Pages source должен быть GitHub Actions.
• Workflow должен запускаться с dashboard: true.
• Первый успешный deploy создает /dashboard/.
• Если Pull Request Deploy заблокирован, open PR data появится после merge.

Заметка

?pr=123 работает только после публикации notes для этой PR.

Dashboard открывает не ту PR

Главная страница Dashboard должна показывать общую историю и не должна принудительно переходить на ?pr=. Только ссылки из PR Report добавляют ?pr=<number> текущей PR.

Если старый Pages deploy всё ещё перенаправляет, перезапустите Dashboard workflow или дождитесь следующего успешного deploy из main.

git commit не отслеживается

npx agent-note status
npx agent-note init --agent claude

Git hooks локальны для .git/, поэтому каждому clone нужен init.

Line Estimate не отображается

Это часто нормально. Claude Code обычно предоставляет достаточно доказательств для Line Estimate. Codex CLI может оценить строки только когда счётчик patches в transcript совпадает с final commit diff. Cursor может оценить строки только когда счётчики edit совпадают и final file всё ещё совпадает с последним AI edit. Gemini CLI сейчас показывает только AI Ratio на уровне файла.

Если доказательств недостаточно, Agent Note возвращается к безопасной оценке вместо догадок.