Skip to content

[bug] hindsight-setup §4: у recall/retain/reflect нет вызывающих в поставке #430

Description

@VxxxlBxxxxv

Что произошло

docs/hindsight-setup.md §4 «How agents use it» обещает три автоматизма и закрывает раздел словами «No manual action required»:

  1. Recall relevant faults before opening a work product or skill
  2. Retain new faults in background (never blocks)
  3. Reflect on weekly patterns during Week Close

В поставке не проведён ни один. После трёх команд установки пилот получает работающий контейнер, в который никто не пишет и из которого никто не читает.

Обещание §4 Фактическое состояние
Recall перед открытием работы или скилла Вызывающего нет. RECALL_SKILLS (шесть скиллов) в hindsight_trigger.py определён, но ни один хук переходник не вызывает. Белый список при этом обслуживается печатной подсказкой человеку в scripts/create-skill.sh:121 («добавить id в RECALL_SKILLS»): список пополняется, читатель не заводится
Retain в фоне Выключено по умолчанию (IWE_HINDSIGHT_RETAIN = 0). Единственные писатели — kimi-peer-adapter.sh и codex-peer-adapter.sh, и отдают они текст ответов напарника, а не косяки агента. Профиль косяков пишется в L1 мимо Hindsight
Reflect на Week Close Вызова нет. В week-close/SKILL.md только health check контейнера (§7f)

Что ожидалось

Либо контур проведён и §4 соответствует поставке, либо §4 описывает, что пилоту нужно настроить руками, без «No manual action required».

Шаги воспроизведения

Проверено против upstream/main, подтянутого 2026-08-13 (вершина b4f24c6, того же дня):

# 1. Ни один хук не регистрирует переходник
git show upstream/main:.claude/settings.json | grep -i "hindsight\|recall\|retain"
# → пусто

# 2. Во всём .claude/ — одно упоминание, health check
git grep -i "hindsight" upstream/main -- .claude/
# → только .claude/skills/week-close/SKILL.md §7f (docker ps / лог / размер БД)

# 3. Вызова reflect на Week Close нет
git show upstream/main:.claude/skills/week-close/SKILL.md | grep -n "reflect\|hindsight_trigger"
# → пусто

# 4. Кто реально ссылается на переходник
git grep -ln "hindsight_trigger" upstream/main
# → CHANGELOG.md, update-manifest.json, hindsight_trigger.py, hindsight_adapter.py,
#   scripts/kimi-peer-adapter.sh, scripts/codex-peer-adapter.sh, scripts/create-skill.sh

Снятые переменные

  • Не устаревшая копия: scripts/hindsight_trigger.py, docs/hindsight-setup.md, exocortex/hindsight/docker-compose.yml в форке и в upstream/main совпадают байт в байт (git diff --stat HEAD upstream/main → 0 изменений).
  • Проверка шла по upstream/main, а не по релизной копии.
  • Дубля не нашёл: gh issue list --state all --search "hindsight OR recall OR retain" — девять записей, ни одной про отсутствующего вызывающего; gh pr list --state all по тем же словам — по контуру памяти ни одной.

Отношение к закрытым #252 и #253

Обе закрыты 2026-07-16 и касались этого же контура: переходник отсутствовал в поставке, retain был no-op из-за прав на файл. Доставку файла починили, проводку не завели — обещания §4 остались невыполненными после закрытия обеих. Похоже на пропущенный follow-up, а не на новый дефект.

Варианты фикса

  1. Провести контур: зарегистрировать hindsight_trigger.py хуком в .claude/settings.json, включить retain косяков, добавить вызов reflect в Week Close.
  2. Привести документ в соответствие: переписать §4 в «что настроить руками», убрав «No manual action required».

Первое честнее по обещанию, второе дешевле и снимает ложное ожидание сразу. Готов прислать PR, если скажете, какой из двух путей предпочтителен.

Контекст

  • Файл: docs/hindsight-setup.md §4; scripts/hindsight_trigger.py; .claude/settings.json
  • Дата: 2026-08-13
  • Форк на коммите 5bad8a1 (2026-08-11), проверка против upstream/main b4f24c6
  • ОС: Ubuntu 24.04 на WSL2

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions