Три движущие части
Ограниченная задача с правилами, которым агент обязан следовать. Формат файла, в котором нет поля для исходного кода. И способ решить, что два анализа говорят об одном компоненте, — та часть, которая по-настоящему трудна.
- Протокол Задание на сканирование Задание на сканирование — ограниченная задача с сроком и явными правилами: только чтение, ничего не запускается, никаких секретов, только относительные пути, текст репозитория считается данными, а не инструкциями, и сетевое правило, разное для подключённого агента и для ручной работы. Что агенту вообще разрешено делать во время анализа 1ADK?
- Протокол Формат Evidence Package Один JSON-файл, описывающий систему: сущности, структура, связи, интерфейсы, данные, утверждения, доказательства, неизвестное и охват. Для чего нужен каждый раздел и для чего в формате намеренно нет поля. Что такое Evidence Package?
- Протокол Снимки и изменения Тождество — трудная задача за любым инструментом, который следит за архитектурой во времени. Как компоненты узнаются между анализами, почему охват решает, что можно сообщить как удалённое, и что такое смысловая разница. Как понять, что два анализа описывают один и тот же компонент?
Почему всё это открыто
Потому что иначе пришлось бы просить верить на слово. Продукт, чьё основное утверждение звучит как «нам не нужен доступ к вашему коду», должен уметь объяснить, что ему нужно, — подробно настолько, чтобы технический человек мог решить, выдерживает ли это утверждение проверку.
Три страницы выше — именно те части, которые для такого суждения важны: что агенту предписано делать, что файл, который он производит, может и не может содержать, и как два таких файла сравниваются. Вместе они отвечают на вопрос, который у скептически настроенного инженера действительно есть, — не «что оно делает», а «где это может пойти не так?»
Что не публикуется
- Полная схема. Публикация её в машиночитаемом виде — отдельное продуктовое решение, которое не принято, и этот раздел его не предвосхищает.
- Серверные внутренности. Устройство хранения, очереди, блокировки, реализация проверок. Ничто здесь не секрет ради секрета, и ничто здесь не помогает читателю судить о границе.
- Всё, что помогло бы атаковать проект клиента. Страница безопасности называет границу и её пределы; карту того, куда давить, она не выдаёт.
Предпросмотр метаданных показывает полный разобранный пример пакета, поле за полем, — практическая версия этого раздела.