Files
healthlog/docs/tasks/items/data-migration-row-selection.md
T
avandClaude Opus 5 a53d0f0f2f задачи: мета переехала в блок, поле «Хук» стало «Зачем»
49 файлов, миграция сделана командой tasks.py check --fix — той самой, ради
которой в скрипте оставлена читаемость старой формы. Побочно тот же прогон
проставил тег decomposed целям, у которых есть задачи: это его штатная работа.

check после миграции зелёный, индексы согласованы.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 17:31:29 +03:00

3.2 KiB

Data-миграции не отбирают строки по обрезаемым спискам

  • Секция: ядро
  • Зачем: Миграция 00007 отбирает по uncovered_sections, который обрезается на 32 — следующая покрытая секция унаследует слепую зону
  • Теги: goal:journal-and-rebuild

Остаток задачи «Дозакрыть находки ревью по слиянию сущностей» (архивный change dozakryt-nahodki-sushchnostej).

Оракул: механизм доказан, дефект пока пустой

Миграция 00007 переводит в pending доставки, у которых имя ставшей покрытой секции стоит в uncovered_sections:

WHERE EXISTS (SELECT 1 FROM json_each(delivery.uncovered_sections)
              WHERE json_each.value IN ('workouts', 'stateOfMind'))

Список uncovered_sections обрезается на 32 имени в порядке встречи (hae.maxUncovered, счётчик UncoveredDropped). Секция, стоящая в теле после тридцати двух незнакомых ключей, в список не попадает — и отбор миграции её не найдёт. Оракул жил в tmp/adv/uncovered_test.go: тело с 32 ключами junk и секцией ecg за ними даёт список без ecg.

Для 00007 дефект пустой: HAE шлёт одну секцию за доставку (docs/research/apple-health.md, находка 50), секций восемь, тела с 32 незнакомыми ключами в архиве не существует. Но следующая покрытая секция унаследует ту же слепую зону, а к тому времени причину никто не вспомнит.

Что делать

Записать принцип и выбрать форму отбора:

  • Принцип: data-миграция не отбирает строки по списку, который где-то обрезается. Отбирать надо по признаку, который обрезке не подлежит, — например «эту доставку смотрел разбор старше версии N».
  • Практическое следствие для существующего кода: UncoveredDropped > 0 обязан означать безусловное пересворачивание — доставка, у которой список обрезан, про своё покрытие ничего достоверного не говорит.
  • Кандидат в docs/conventions/README.md (раздел про миграции), если форма отбора окажется общей.

Связано