49 lines
3.4 KiB
Markdown
49 lines
3.4 KiB
Markdown
# AGENTS.md — Launcher Next
|
||
|
||
## Scope
|
||
|
||
Эти правила относятся только к Launcher Next. Работать с текущей веткой и
|
||
локальными test fixtures; не делать production deployment, не менять default
|
||
branches и не создавать новую ветку или worktree без прямого задания.
|
||
|
||
## Общая карта проекта
|
||
|
||
Каноническая общая карта проекта:
|
||
`https://drive.google.com/drive/folders/1avnR0V8q7y5pfWRYwB6LPBEEyfpN7PpV`.
|
||
Необязательный локальный доступ к синхронизированной копии возможен только
|
||
через `PHIM_PLANT3D_PROJECT_MAP_ROOT`; путь синхронизации не хардкодить.
|
||
|
||
Перед архитектурной, package-lifecycle или runtime работой читать доступные
|
||
индекс/обзор карты, запись Launcher architecture и migration status, package
|
||
activation/rollback contract, индекс runtime evidence и записи затронутой
|
||
интеграции. Сверять их с локальным AGENTS.md, tracked documentation, code,
|
||
tests, configuration, фактическим `git rev-parse HEAD` и runtime evidence.
|
||
|
||
Приоритет источников: фактическое runtime evidence; code/tests/configuration
|
||
на проверенном Git HEAD; tracked documentation; общая карта проекта. Внешняя
|
||
документация не является build/runtime dependency и не переопределяет текущий
|
||
код или runtime evidence. Недоступность карты фиксировать как
|
||
`PROJECT_MAP_UNAVAILABLE`; несовпадение её commit/runtime status с фактическими
|
||
данными — как `PROJECT_MAP_STALE`. В обоих случаях продолжать только по
|
||
доступным источникам и явно сообщать расхождение.
|
||
|
||
## Launcher invariants
|
||
|
||
Launcher использует versioned local package, проверяемый manifest и один
|
||
managed entry assembly; Autodesk DLL не включаются в package и не загружаются
|
||
с UNC. Headless automation требует явного NextPilot mode, не создаёт Foundation
|
||
UI, не ожидает ввода и не возвращается в Legacy/default route при ошибке.
|
||
Production route не создаёт pilot session или automation manifest и не
|
||
использует `/b`.
|
||
|
||
До hashing сохранять immutable manifest и initial evidence; session/progress,
|
||
terminal evidence, cancellation, rollback и package activation должны быть
|
||
проверяемыми. Runtime evidence определяет реальный статус запуска AutoCAD,
|
||
активации и cleanup — build и unit tests его не заменяют.
|
||
|
||
После изменения Launcher architecture, package activation/rollback либо
|
||
runtime-status в отчёте перечислять документы карты, которые требуют
|
||
обновления: Launcher architecture, package lifecycle, runtime evidence index,
|
||
migration status и запись затронутой интеграции. Не заявлять обновление карты
|
||
без фактического внешнего изменения.
|