Ссылки и «Где используется»

Как связать файл с задачей, документом или прогоном харнесса, как работает «Где используется» и что происходит со ссылками при переименовании, новой версии и удалении.

Файл в Артефактории ценен не сам по себе, а тем, к какой работе он относится. Поэтому у каждого файла есть раздел «Где используется»: список задач, документов и прогонов харнесса, которые на него ссылаются. Связи появляются сами — достаточно упомянуть слаг.

Три вида связи

Вид в «Где используется»	Откуда берётся
упоминание	Слаг `AF-ARTF-12` встречается в заголовке или описании ноды, в любом комментарии к ней или в тексте документа
ссылка	Агент явно добавил файл в ссылки ноды (инструмент `set_references`)
результат	Шаг прогона харнесса сдал файл как свой результат

Каждая строка — слаг и заголовок источника; щелчок открывает задачу, документ или прогон.

Упоминания

Чтобы связать файл с задачей, просто напишите его слаг в тексте — руками или кнопкой «Прикрепить из Артефактория»:

комментарий к AF-TASK-42

[blocker] Падает на данных заказчика — дамп в AF-ARTF-31, лог в AF-ARTF-32.

Что произойдёт:

В тексте комментария оба слага станут чипами с иконкой и именем файла.
У AF-ARTF-31 и AF-ARTF-32 в «Где используется» появится AF-TASK-42 с видом «упоминание».
Если позже убрать слаг из текста или удалить комментарий, связь исчезнет сама.

Правила:

Слаг должен стоять отдельным словом. Слаги в блоках кода и внутри готовых ссылок не трогаются.
Учитываются только слаги своего проекта. XY-ARTF-5 из чужого проекта останется текстом.
Связь появляется не мгновенно, а через несколько секунд после сохранения.

Слаги файлов в комментариях — Слаги в тексте стали чипами; окончательно удалённый файл показан зачёркнутым.

Что происходит при изменениях

Что сделали с файлом	Что со ссылками
Переименовали или перенесли	Ничего — слаг тот же, ссылки работают
Загрузили новую версию	Ничего — ссылки ведут на файл, а не на версию; открывается последняя
Удалили в корзину	Чипы ведут на файл в корзине; файл можно восстановить, и всё снова работает
Удалили навсегда	Чипы показываются зачёркнутым слагом — «такой файл был, но удалён», а не «опечатка»

Удаление файла, на который ссылаются

Удаление используемого файла требует подтверждения:

В вебе диалог заранее покажет «Файл используется. Удаление оставит ссылки на удалённый файл:» и список источников. Кнопка — «Удалить всё равно».
Через MCP artifact_delete без confirm: true откажет и перечислит, кто ссылается: «artifact is in use by AF-TASK-1, …; repeat with confirm to delete anyway».
Встроенный агент объяснит последствия и удалит только после вашего «Разрешить».

Это защита от тихо сломанных ссылок: решение «эта задача больше не нуждается в файле» должен принять человек.

Удаление используемого файла — Диалог заранее показывает, какие ссылки сломаются.