svc-api-x/analysis/new-chat-handoff-2026-04-29.md

# Handoff для нового чата

Работаем с локальной копией репозитория, НЕ с mounted-папкой на VM. Предыдущая сессия шла в sshfs-монте, из-за этого были зависания git write-tree, git diff --name-only и периодическая рассинхронизация. В новой сессии нужно продолжать только в обычной локальной папке на диске.

## Задача

- аккуратно очистить исходники svc-api-x по этапам
- каждый этап фиксировать отдельным локальным коммитом
- не пушить
- документировать ВСЁ отдельно в папке analysis
- не спешить, действовать консервативно
- в конце собрать оглавление файлов и единый markdown-документ со всеми исходниками
- после выполнения подготовить вопросы заказчику по неоднозначным местам

## Очень важно

- если переносишь репу локально, нужно переносить всю репу вместе с .git, чтобы сохранить уже сделанные локальные коммиты и ветку cleanup/svc-api-package
- если это уже новая локальная копия, сначала проверь, что история и ветка сохранились
- не удалять файлы автоматически без высокой уверенности
- не трогать vendor-слой Taffy на ранних этапах
- не лезть сразу в большие рискованные файлы вроде Application.cfc и instance.cfc без отдельного аккуратного прохода
- продолжать документирование в analysis

## Текущее состояние ветки и коммитов

- рабочая ветка: cleanup/svc-api-package
- текущий HEAD: 44daae628d24502730745a94f2f3665474f22c4a
- ранее были созданы локальные cleanup-коммиты через git plumbing, потому что обычный git commit и часть git-команд подвисали на mounted-репе

### Известные cleanup-коммиты

- f6d5c868cb54b87c1daffdeda95689a5f121ca8f
  - message: cleanup: remove legacy headers and commented alternatives
- 7b98eee156c3251bdd37a4d22d3596ba671a447c
  - message: cleanup: remove reasoning comments and translate helper docs
- 44daae628d24502730745a94f2f3665474f22c4a
  - message: cleanup: trim list resources and remaining helper comments

## Что уже сделано по коду

- очищены и частично переведены helper-файлы
- выполнен консервативный проход по небольшим resource list-файлам
- ведётся внешний журнал работы в analysis

### Файлы, которые уже правились

- analysis/cleanup-worklog-2026-04-29.md
- v1/lib/TokenGenerator.cfc
- v1/lib/field_set.cfm
- v1/lib/order_build.cfm
- v1/lib/rest_api_helper.cfc
- v1/resources/svc_default.cfc
- v1/lib/field.cfm
- v1/lib/filter_build.cfm
- v1/resources/catalog_service_ls.cfc
- v1/resources/catalog_service_param_ls.cfc

### Что уже сделано по смыслу

- удалены старые version-header комментарии там, где это безопасно
- удалены закомментированные альтернативные строки и debug-хвосты
- удалены комментарии в формате внутренних рассуждений там, где это явно безопасно
- переведена часть английских комментариев в helper-слое
- syntax/errors на изменённых файлах проверялись, явных ошибок на затронутых файлах не было

## Какие файлы сознательно НЕ трогались или почти не трогались

- v1/Application.cfc
- v1/resources/instance.cfc
- крупные и неоднозначные instance/operation resource-файлы
- весь vendor-слой v1/taffy
- backup-каталоги v1/resources/bk и v1/etc/bk

## Какие аналитические файлы уже созданы

- analysis/project-history-analysis.md
- analysis/project-history-analysis-careful-2026-04-29.md
- analysis/task-brief-2026-04-29.md
- analysis/cleanup-worklog-2026-04-29.md

## Важно по журналу

- продолжать писать именно в analysis/cleanup-worklog-2026-04-29.md
- перед каждым новым заметным этапом фиксировать, что собираешься делать
- после этапа фиксировать результат, что вошло, что сознательно не трогалось и почему

## Что сделать в новой сессии первым делом

1. Проверить, что открыт именно локальный путь, а не mounted sshfs-копия.
2. Проверить текущую ветку и HEAD.
3. Проверить, чистое ли рабочее дерево.
4. Открыть и прочитать analysis/cleanup-worklog-2026-04-29.md, чтобы продолжать журнал в том же стиле.
5. После этого выбрать следующую небольшую безопасную группу файлов для зачистки.

## Какой следующий шаг по коду предпочтителен

- не идти сразу в Application.cfc
- взять ещё 1-2 компактных resource-файла с плотным, но безопасно удаляемым comment/dead-code слоем
- кандидатами могут быть небольшие list-resource или compute/helper resource-файлы, но только после чтения
- перед правкой обязательно посмотреть текущий файл целиком или значимую часть
- править минимально и без рефакторинга логики

## Стратегия на продолжение

- маленькие партии файлов
- отдельный лог в analysis
- отдельный локальный commit на каждый смысловой этап
- сначала убирать комментированный мёртвый код и явно лишние рассуждения
- потом переводить оставшиеся полезные английские комментарии
- только потом переходить к более крупным и рискованным файлам

## Что НЕ делать

- не удалять cfm/cfc-файлы автоматически по догадке
- не трогать vendor Taffy без отдельного решения
- не смешивать много разных смысловых этапов в один commit
- не пытаться причесать всё сразу
- не переписывать логику ради красоты
- не пушить

## Отдельно учесть

- файл analysis/task-brief-2026-04-29.md мог быть изменён пользователем после прошлой сессии, поэтому перед любыми правками его нужно перечитать и не затирать пользовательские изменения
- если локальная копия создавалась копированием, а не переносом всей .git-истории, нужно сразу выяснить, есть ли коммиты f6d5c868cb54b87c1daffdeda95689a5f121ca8f, 7b98eee156c3251bdd37a4d22d3596ba671a447c, 44daae628d24502730745a94f2f3665474f22c4a; если их нет, надо либо перенести ветку, либо повторить уже сделанные этапы осознанно, а не вслепую

## Цель ближайшей итерации

- подтвердить локальную среду
- продолжить worklog
- выбрать следующую безопасную группу файлов
- сделать ещё один аккуратный cleanup-stage
- проверить syntax/errors
- создать следующий локальный commit

## Если состояние локальной копии не совпадает с ожидаемым

Сначала нужно коротко описать расхождение и только потом продолжать правки.