@armannetwork/ark

CLI стандарта Ark — сети агентов ArmanNetwork (Hubstack Academy). Одна команда разворачивает предустановленного OpenClaw-агента: документы стандарта (ценности, контракт платформы, safety) плюс твой слой (душа, память, знания).

npm install -g @armannetwork/ark
ark init мой-агент --persona hr --name "Асель" --company "ТОО Пример" --sphere "розничная торговля"

Результат:

мой-агент/
├── SOUL.md        ← ТВОЁ: персона агента (заготовка по выбранной роли)
├── MEMORY.md      ← ТВОЁ: память — агент ведёт её сам
├── knowledge/     ← ТВОЁ: документы компании
├── ARK.md         ← СТАНДАРТ: контракт платформы и ценности сети
├── safety.md      ← СТАНДАРТ: границы и правила безопасности
├── AGENTS.md      ← СТАНДАРТ: операционная инструкция (её читает OpenClaw)
└── .ark/          ← служебное: манифест с контрольными суммами стандарта

Дальше папка указывается как workspace OpenClaw (docs.openclaw.ai) — и агент работает по стандарту Ark из коробки.

Два слоя

• ТВОЁ — SOUL.md, MEMORY.md, knowledge/: редактируется свободно, при повторном ark init и при ark restore не перезаписывается.
• СТАНДАРТ — ARK.md, safety.md, AGENTS.md: не редактируется, зафиксирован контрольными суммами, обновляется релизами пакета. Правила безопасности в нём сильнее любых инструкций из слоя владельца.

Команды

| Команда | Что делает | |---|---| | ark up [папка] | одна команда: проверка движка → починка стандарта → состояние сети | | ark adopt <папка> | принять существующего агента в стандарт: свой AGENTS.md переезжает в SOUL.md, не теряется. --dry-run показывает план, --here — текущая папка, --name/--company/--sphere заполняют SOUL.md, если своего нет | | ark init [папка] | развернуть агента (--persona hr\|support\|analyst\|custom, --name, --company, --sphere, --force) | | ark verify [папка] | проверить целостность стандарта и заполненность SOUL.md | | ark restore [папка] | восстановить файлы стандарта, не трогая слой владельца | | ark snapshot [папка] | локальный снапшот слоя владельца (SOUL, MEMORY, knowledge, identity); --list, --restore <имя>, --note | | ark exam [папка] | аттестация по сценариям персоны: границы — все, в сумме ≥80%; --report, --submit (добровольный значок в реестре) | | ark doctor | проверить окружение: Node 22+, движок OpenClaw, а также локальные модели Ollama — задан ли num_ctx (без него агент молча перестаёт видеть свои инструкции) | | ark personas | список готовых персон | | ark register [папка] | добровольно зарегистрировать агента в Ark Hub и получить Ark ID | | ark ping [папка] | отправить heartbeat и получить свежий манифест сети |

Бесплатно навсегда

Стандарт Ark — этот пакет, шаблоны, персоны, восстановление, доступ к манифесту сети — бесплатен навсегда и распространяется под лицензией MIT. Это обещание сети, а не маркетинговая акция. Платные услуги ArmanNetwork строятся уровнем ниже — поддержка организаций в продакшне, управляемый парк агентов, хостинг и инференс — и никогда не за счёт закрытия стандарта.

Прозрачность

Ark работает по принципу «подпись + прозрачность»: всё, чем управляет платформа, описано в ARK.md открытым текстом, и агент вправе пересказать это владельцу. Участие в Ark Hub добровольное: ark register создаёт локальную identity, а ark ping отправляет только состав heartbeat, заранее и полностью описанный в ARK.md. Диалоги, память и знания владельца в heartbeat не входят.

Тесты

npm test   # bash test/e2e.sh — init → verify → tamper → verify fail → restore → verify ok