Карта ответственности для небольших изменений
Карта завершает разбор границ в #624 на коммите 78b7da480634313ff97b96b0eb1fbe5ecd32aecc. Шесть файлов ниже остаются рабочими точками входа. Длина файла сама по себе не является причиной переноса кода. Для следующего выделения нужны конкретное изменение поведения, потребитель и проверка наблюдаемой гарантии.
Текущая ответственность и границы изменений
| Точка входа | Ответственность сейчас | Граница небольшого изменения |
|---|---|---|
| InstallerWizardViewModel | Состояние страниц и выбора, обзор и согласие, запуск установки/восстановления, прогресс и записанные результаты. | Состояние UI и согласие остаются в мастере. Тексты завершения/восстановления уже получают неизменяемые факты через InstallerRunMessages. Новый координатор исполнения нужен лишь для конкретного изменения запуска/восстановления: он получает согласованный план и возвращает события/результаты, а представление не получает права выполнять эффекты. |
| CodeSearchSyncCommand | Блокировка репозитория, планирование базы и worktree, семантика перед эмбеддингами, прогресс, проверки изменений дерева, публикация и очистка. | Сохраняется один владелец оркестрации и времени жизни блокировки. План фиксирует дерево; фазы создают артефакты для этой идентичности; публикация проверяет и открывает готовый результат. WorktreeGenerationPublications уже владеет ранним указателем, привязанным к эпохе общего указателя. Фаза выделяется только при конкретной потребности. |
| DurableQueue | Приём/дедупликация и порядковые номера, состояние и аренды, проверенные payload, восстановление, архив/карантин и очистка. | Метаданные, проверка payload и очистка — разные обязанности внутри одной транзакции mutex. Кеш запросов ограничен текущим владением mutex. Помощник получает этот контекст либо проверенные значения, не вводит отдельную блокировку и не сохраняет payload между операциями. Опрос состояния остаётся без чтения payload. |
| BrokerModelInstaller | Доверенный снимок запросов, проверка подписанного каталога, аренда активной версии, команды launcher, проверка status/pull/preflight, прогресс и точные частичные результаты. | Существующие интерфейсы доверия, активной версии и процессов — границы, а не публичный обход проверок. Новое поле протокола может потребовать отдельного узкого парсера/валидатора. Он возвращает факты владельцу пакета операций, сохраняющему доверие, отмену и различие между попыткой, завершением и неизвестным результатом эффекта. |
| InstallationLayoutLease | Получение защищённого Windows layout, удержание дескрипторов и свидетельств identity/ACL, временные версии и публикация, резервирование launcher и очистка собственных изменений. | Дополнительное выделение сейчас не выбрано. Конкретный дефект публикации/резервирования может потребовать выделения только соответствующей операции; дескрипторы и свидетельства остаются живы под арендой. Нельзя заменять операции относительно дескрипторов проверкой пути перед незащищённым действием. |
| IndexBuilder | Разделение и переиспользование файлов, чанки по символам, сборка базы/overlay, пакеты эмбеддингов через брокер, восстановление checkpoint, адаптивные лимиты, ожидание backend и прогресс. | Дополнительное выделение сейчас не выбрано. Измеренный дефект сборки, повторов или checkpoint может потребовать одного закрытого помощника плана/фазы. Входы сохраняют хеши, chunker, модель/размерность/контекст и порядок. Запись индекса не даёт помощнику права публиковать поколение репозитория. |
Последние два решения условны: #624 не задаёт отдельное переписывание защитного кода или индексатора. В этом изменении документации нет абстракций без потребителя, постоянного кеша очереди, миграции хранилища или изменений публичного API.
Связь с существующей работой
| Ответственность | Задача и выполненное изменение | Что остаётся в этой задаче |
|---|---|---|
| Исполнение установки и представление результата | #615, PR #671 | Мастер передаёт записанные факты; смена языка не выполняет установку и не переписывает журнал. Достоверность отмены/эффектов относится к #589, представление результата — к #604. |
| Планирование, фазы и публикация sync | #620, PR #676 | Готовность запрошенного worktree и полное обслуживание имеют разные результаты. Общие читатели сохраняют прежнее поколение до подготовки всех нужных worktree. Дублирующая задача рефакторинга sync не создаётся. |
| Метаданные, payload и очистка очереди | #621, PR #677 | Переиспользование ограничено одним владением mutex; следующая операция заново проверяет payload на диске. Очистка остаётся под той же блокировкой. Измеренное улучшение не требует разделения всего класса. |
| Производительность индекса и запросов | #619 | Идентичность вектора запроса, задержки и качество выдачи остаются этой задачей. Перенос IndexBuilder не заменяет измерение пути запроса. |
Карта закрывает координационную работу #624. Она не переоткрывает завершённые задачи и не объявляет завершёнными оставшиеся оптимизации или живую приёмку установщика.
Сохраняемые гарантии
Установщик и модели. Согласие предшествует эффектам. Факты журнала/результата определяют завершённые, неудачные и неизвестные действия; форматирование не меняет их и доступность отката. На протяжении исполнения сохраняются свидетельства проверенного пакета, launcher и активной версии, проверяются каталог/модель/контекст ответа, уже установленные модели проходят preflight, политика размещения не ослабляется автоматически. Существующие проверки: мастер и установщик моделей.
Sync и индексатор. Блокировка репозитория берётся до записи общего состояния и охватывает публикацию. Семантика и корпус описывают одно поколение, дерево и dirty-состояние. Изменившийся worktree не публикует устаревшие артефакты; ранний указатель действует только в записанной эпохе общего указателя. Отмена/ошибка сохраняет доступные опубликованные поколения и готовые checkpoint. Сохраняются совместимость модели и размерности базы/overlay, идентичность chunker и нормализация, включая переиспользование неизменённых файлов. Проверки: активная публикация, эпохи и хранение, продолжение эмбеддингов, восстановление backend, адаптивные пакеты.
Очередь. Общий mutex защищает номера, дедупликацию, согласованность request/state, переходы аренды и восстановление. Проверенные payload не переживают эту аренду, включая выход с исключением. Подмена с прежним размером и временем проверяется следующей операцией; некорректная запись попадает в карантин. Сохраняются durable JSON и смысл архива/очистки. QueueRequestSnapshotTests проверяет границы кеша; сохранённые замеры и конкуренция реальных процессов относятся к измеренному изменению.
Защищённый layout. Каноническая идентичность, проверки ACL/reparse и время жизни дескриптора связаны с операцией. Перед commit/publication выполняется повторная проверка; откат/очистка удаляет только собственные изменения. Строка пути не заменяет удерживаемое свидетельство. Тесты установки пакета включают отказ при опасных существующих ACL без изменения данных; тесты общего корня проверяют допустимое существующее состояние. Это опорные регрессии, а не доказательство отсутствия любых гонок файловой системы.
Приёмка следующего небольшого PR
- Указать задачу, потребителя и наблюдаемый сценарий, требующий границы. Один PR меняет одну ответственность и сохраняет точку входа, если задача не требует изменения контракта.
- Для нового поведения сначала воспроизвести сбой. Для выделения сохранить наблюдаемые проверки и добавить тест только для непокрытой гарантии. Не проверять помощника лишь потому, что он появился, и не задавать порог скорости машины.
- Явно сохранить время жизни блокировок/аренд, отмену, владение данными и право публикации. Сохранить JSON и границы untrusted-content. До принятия оптимизации сравнить результаты на существующем корпусе.
- Перед открытием PR выполнить полный прогон:
dotnet test LocalAi.slnx --configuration Release --max-parallel-test-modules 1 --timeout 20m. Указать итоги и причины пропусков. Проверки фикстур не подтверждают живую приёмку DPI, доступности или установки.
Для этой карты код и опорные тесты сверены с указанным коммитом. Рабочий код и тесты не изменены. Результат полного прогона и проверка локальных ссылок записываются в PR. Утверждений о производительности моделей или экономии облачных токенов нет.