xboct-flow/docs/AUDIT-PLAN.md

Аудит и план доработок

1. Невыполненный пункт todo.md

• Боковая панель — при изменении настроек должна обновляться (или кнопка refresh)
  • todo.md:58-60

---

2. Рефакторинг: слияние frontmatterBlock.ts → frontmatterFields.ts

Зачем

frontmatterBlock.ts (148 строк) — единственный крупный модуль без единого теста. Его логика (поиск строк/позиций в frontmatter) тесно связана с frontmatterFields.ts. Ни один другой потребитель не требует отдельного файла.

План

1. Перенести весь код frontmatterBlock.ts в frontmatterFields.ts
2. Убрать export * from "./frontmatterBlock" и соответствующий import
3. Обновить импорты в validateFrontmatter.ts и parseTaskTags.ts
4. Удалить frontmatterBlock.ts
5. Написать unit-тесты на перенесённые функции:
   • extractFrontmatterBlock — валидный/без закрытия/без frontmatter/пустой/CRLF
   • findFieldLineRange — поле найдено/не найдено/с отступами

---

3. Тесты на edge cases

🔴 Приоритет: высокий

Модуль	Недостающие кейсы
dashboard/sortTasks	пустой массив, одинаковые created, невалидные даты
kanban/buildKanbanBoard	одинаковые updated (стабильность sort)
storage/FsTaskRepository	ошибки fs при readdir/readFile/writeFile/deleteFile, кириллица в заголовке, title ровно 80 символов, теги с кавычками/спецсимволами
dashboard/applyRawTaskContent	raw с другим порядком полей, raw без тела (description)
dashboard/buildDashboardView	пустой массив задач (tasks: [])
dashboard/groupTasks	неизвестный статус/приоритет в данных

🟡 Приоритет: средний

Модуль	Недостающие кейсы
—	Интеграционный тест: create → serialize → write → read → parse (полный цикл через файл)
dashboard/filterTasks	пустой массив, все фильтры пустые
FsTaskRepository	конфликт ID при merge задач из project + global

---

4. Хрупкие тесты

Snapshot-тесты

• model/taskStatus.test.ts — toMatchSnapshot() на TaskStatus
• model/taskPriority.test.ts — toMatchSnapshot() на TaskPriority

Ломаются от любого изменения порядка ключей.

→ Заменить на toEqual() с явными ожиданиями.

_unsafeUnwrap() вместо проверок isErr/isOk

7 мест, где используется _unsafeUnwrap() — при падении теста вместо понятной assertion ошибки будет RuntimeError: called _unsafeUnwrap on an Err:

• src/commands/addProjectTag.test.ts:27,28,50,63,66
• src/projectConfig/parseProjectConfig.test.ts:14,15,24
• src/projectConfig/serializeProjectConfig.test.ts:11,17

→ Заменить на isErr()/isOk() + if (result.isErr()) return паттерн.

---

5. Untested-модули (кроме UI/vscode-адаптеров)

Модуль	Строк	Действие
src/config.ts	60	После слияния frontmatterBlock.ts останется самым крупным untested модулем. Стоит покрыть: getConfigSection, getSettingDefault, ошибки при missing keys
src/model/taskFile.ts	46	isTaskFileName + константы — можно быстрый unit

---

Порядок работ (рекомендуемый)

1. Рефакторинг — слияние frontmatterBlock.ts → frontmatterFields.ts + тесты
2. Edge case тесты — FsTaskRepository, sortTasks, buildKanbanBoard, applyRawTaskContent
3. Хрупкие тесты — snapshot → toEqual, _unsafeUnwrap → безопасный паттерн
4. config.ts + taskFile.ts — unit-тесты
5. todo.md — refresh боковой панели
6. Интеграционный тест — полный round-trip через файл