[zeegin]

Closes #736

Порядок вливания: вместе с #735 или после него. Формулировка «AgentBaseDir в workPath» верна для живого агента только после #735.

Публичные документы и сайт приведены к тому, где раннер на самом деле хранит данные. Каждое утверждение сверено с кодом: src/support/machine.rs (state_dir_location, account-salt), src/platform/agent_keeper/{mod.rs,server.rs,client.rs}, src/platform/agent.rs (create_for, host_key_fallback_roots), src/use_cases/agent_session.rs (~692–704), src/platform/service_record.rs, src/domain/source_set.rs, src/config/loader.rs, src/use_cases/infobase_owner.rs.

Согласовано с #735: в выпуске 0.17.4 AgentBaseDir и текущий каталог живого агента переезжают в workPath. Поэтому PR не пишет, что они лежат в каталоге состояния. Строка запуска агента (/AgentBaseDir <workPath>/agent/base) оставлена прежней. Каталог состояния описан как место, где лежат запись и журнал сторожа, ключ хоста живого агента, bin/ и account-salt. V8_RUNNER_STATE_DIR не описывается: её судьбу решает #735.

Что изменилось

• docs/CONFIGURATION.md
  • workPath/agent/: ключ хоста в workPath/agent/host-keys есть только у разового агента. Ключ живого агента, его запись и журнал сторожа лежат в каталоге состояния.
  • Ключ хоста: ключ живого агента лежит в agents/<ключ>/agent/host-keys/ в каталоге состояния, ключ разового — в workPath/agent/host-keys/.
  • Запасной каталог для ключа на пути не в ASCII: у живого агента это каталог состояния под %LOCALAPPDATA%, например при кириллическом имени пользователя Windows.
  • Добавлен состав каталога состояния: agents/<ключ>/agent/{record.json,agent.log,host-keys/}, bin/<версия>/, account-salt. Путь к agent.log называет отказ agent_start у agent hold, когда сторож вышел, не ответив, или не ответил вовремя. Каталог лежит в профиле пользователя, обычно на системном диске.
  • В дерево localPath добавлены managed/owner.json, standalone.log, ras.log и host-key автономного сервера.
• docs/CAPABILITIES.md: та же правка строки про workPath/agent, с путями каталога состояния.
• SKILL/SKILL.md: в строку про живого агента добавлено, где лежат запись и журнал сторожа (agent.log) и ключ хоста. Сказано и то, что при отказе сторожа команда работает с разовым агентом (reason: keeper_failed), а agent hold отказывает с agent_start и называет этот журнал.
• docs/site/architecture.html
  • В таблице компонентов три строки: workPath, localPath и каталог состояния учётной записи.
  • В правиле замка различаются разовый и живой агенты.
  • Таблица «Сколько живёт»:
    • память о базе лежит в localPath;
    • живой агент переживает команду и закрывается через 15 минут простоя без держателя или по agent stop; запись и журнал сторожа и ключ хоста лежат на системном диске учётной записи; при отказе сторожа команда работает с разовым агентом (keeper_failed), а agent hold отказывает с agent_start;
    • разовый агент живёт до конца команды;
    • автономный сервер можно поднять командой standalone start, и тогда он живёт до standalone stop.
  • Выводы под таблицей исправлены.
• docs/site/sources.html: в таблице и дереве памяти о базе указан localPath (корень .local/ # localPath).
• docs/site/glossary.html: исправлена статья workPath, добавлена новая статья localPath.
• docs/site/usecases.js: артефакт state теперь называется «память о базе в localPath».
• docs/site/problems.html: память о базе лежит под localPath.
• docs/site/project.html
  • После удаления workPath память о базе сохраняется, и push идёт по изменившемуся. Без памяти о базе (например, если стереть localPath/infobases/<база>) push отказывает с untracked_base и в error.next называет, как восстановить связь.
  • Исправлен комментарий к workPath в примере.
• docs/site/variant-file.html: база задана как File=.local/db. В дереве каталогов показаны localPath и метка владельца .db.v8-runner.owners.json.
• docs/site/scenarios.html: файловая база в «Подборе» — File=.local/db.
• docs/site/diagrams.py и пересобранные схемы
  • На d-cluster-managed адрес Конфигуратора исправлен на Srvr=127.0.0.1:<regport>, как в src/platform/ragent.rs.
  • Подписи узлов на схемах d-standalone-managed и d-cluster-managed — localPath.
  • С подписи workPath на d-file убраны хеши.
• Комментарии к workPath в примерах variant-cluster, variant-standalone, variant-containers и variant-publication.
• Пересобран docs/site/search-index.json.

Пункт issue про architecture.html:289 («AgentBaseDir в workPath») сознательно оставлен как есть. После #735 он будет верен для обоих видов агента.

Проверки

• python docs/site/diagrams.py && python docs/site/check_diagrams.py: 0 замечаний.
• python docs/site/build_search_index.py: 44 страницы, 971 раздел.
• python docs/site/check_target_content.py: OK, 4 теста.
• python scripts/site_matrix.py: зелёный, 7 известных расхождений из site_matrix_known.txt.
• python docs/site/test_cli_reference.py: 6 из 7 тестов проходят. Тест test_response_inventory_covers_target_classes_and_error_codes падает так же на чистом origin/master: в таблице ответов глоссария нет 9 кодов (agent_limit, live_agent_off, infobase_sessions и др.). Эта правка падение не вызывает и не исправляет.
• Сборка и тесты Rust не запускались: Rust-код не менялся.

🤖 Generated with Claude Code