Оновлення

Перехід наявного встановлення на новішу версію відбувається на місці - без нового налаштування. Ваші секрети (.env.local), ваша конфігурація (agents.config.json), ваші дані (~/.maven, сховище (vault) Obsidian), ваші входи в CLI (claude / codex / hermes / …) і локальні рушії (~/wm-engine, ~/openseo) лишаються точно там, де були. Замінюється лише вихідний код застосунку.

Оновлювач усередині застосунку

Коли доступна новіша версія, з’являється банер оновлення. Він показує версію і що змінилося. Версія - це авторитет: банер пропонує оновлення лише тоді, коли віддалена версія справді новіша, тож він ніколи не пропонує відкат на старішу.

Натисніть Update. M.A.V.E.N підтягує оголошений коміт, ставить залежності через npm ci --ignore-scripts, збирає й перезапускається. Перебіг показується в оверлеї; коли все завершиться, сторінка перезавантажується вже на новій версії. Збірка, що не вдалася, відкочується до попередньої робочої збірки.

Заплановані перевірки виконуються двічі на день - типово о 09:00 і 21:00 за місцевим часом, обидві години налаштовуються в Settings → Updates. Перевірка лише показує банер. Автоматичні оновлення типово вимкнені; якщо їх увімкнути, оновлення застосовується щонайбільше раз на UTC-добу і лише коли віддалена версія новіша.

Для приватного репозиторію оновлювачу потрібен токен із правом читання в .env.local: спершу він читає GITHUB_MAVEN_UPDATE, потім GITHUB_TOKEN, потім GH_TOKEN. Токен передається git через GIT_CONFIG_*, ніколи - в командному рядку, тож він не може витекти в логи.

Ручний node scripts/self-update.mjs потребує попереднього Check now (або --expect-sha= / --allow-unverified) - оновлювач застосовує лише той коміт, який оголосив.

Встановлення з zip

Встановлення без git-репозиторію не може підтягувати зміни; воно оновлюється розпакуванням нового zip, і банер так і каже. Процедура, з вашої теки встановлення:

# 1) Stop the running app - pick the line for YOUR OS.
systemctl --user stop maven                                        # Linux (systemd)
# launchctl unload -w ~/Library/LaunchAgents/com.maven.app.plist   # macOS (launchd)
# Stop-ScheduledTask -TaskName MAVEN                               # Windows (PowerShell)
#   … no autostart? just stop your `npm run dev` / `npm start` process.

# 2) Back up your secrets.
cd ~/maven && cp .env.local ~/maven-env-$(date +%Y%m%d).bak 2>/dev/null || true

# 3) Swap in the new source. --delete removes files REMOVED in the new version
#    (renamed apps); the --exclude list protects your local-only files.
unzip -oq ~/maven-<VERSION>.zip -d /tmp/maven-new
rsync -a --delete \
  --exclude='.env.local' --exclude='.env.*' --exclude='agents.config.json' \
  --exclude='node_modules' --exclude='.next' --exclude='.git' \
  --exclude='.claude' --exclude='generated' --exclude='*.tsbuildinfo' \
  /tmp/maven-new/maven-<VERSION>/ ~/maven/
rm -rf /tmp/maven-new

# 4) Refresh deps and restart.
cd ~/maven && npm install
systemctl --user restart maven                                     # Linux
# launchctl load -w ~/Library/LaunchAgents/com.maven.app.plist     # macOS
# Start-ScheduledTask -TaskName MAVEN                              # Windows

Немає rsync? unzip -o ~/maven-<VERSION>.zip -d /tmp/mv && cp -a /tmp/mv/maven-<VERSION>/. ~/maven/ оновлює й додає файли, але залишає видалені на місці (зазвичай нешкідливо). На Windows для shell-команд використовуйте Git Bash або WSL.

Після перезапуску відкрийте http://localhost:3000; якщо щось виглядає не так, читайте логи - journalctl --user -u maven -f (Linux), ~/.maven/maven.err.log (macOS) або історію Scheduled Task (Windows).

Оновлення з ≤ 6.15.x - реліз безпеки (прочитати один раз)

Користуєтеся M.A.V.E.N лише на цій машині (127.0.0.1 / localhost)? Вам нічого робити не потрібно. Ні PIN, ні нового екрана, ні налаштувань для зміни.

Оновлення виконується саме, і на самій машині нічого не ламається. post-update робить разову міграцію: .env.local і копії облікових даних стають 0600, боти 3D-Forge отримують секрет хука, а звіт називає, де лежить віддалений PIN. Що ви можете помітити:

У вас було…	Після оновлення
M.A.V.E.N лише на цій машині	Нічого не змінюється. Тепер існує PIN для віддалених хостів (`~/.maven/access-pin`, також у Settings → Security) - на той день, коли він знадобиться.
M.A.V.E.N відкритий через Tailscale / LAN без PIN	Цей хост один раз спитає PIN: введіть той, що в Settings → Security → Reveal (або `cat ~/.maven/access-pin`). Хост запам’ятовується; сесія живе 30 днів.
Задано `MAVEN_ACCESS_PIN=…`, у браузері вже розблоковано	Ваша cookie розблокування приймається один раз і перевидається; хост запам’ятовується. Ваш PIN так само діє скрізь (і на loopback) - перемкніть режим у Settings → Security, якщо хочете loopback відкритим.
Задано `MAVEN_ACCESS_PIN=…`, cookie сплила / новий пристрій	Екран розблокування на тому хості; ваш PIN працює; хост запам’ятовується.
PIN коротший за 8 символів	Усе ще працює; лог один раз попередить. Змініть його в Settings → Security.
Консоль OpenCode з автопідтвердженням	Тепер вона питає дозволи. `MAVEN_CHAT_PERMISSION_MODE=bypass` повертає стару типову поведінку. Автономні застосунки (OpenMontage, цілі Hermes, Loop, Pipeline) не змінилися.
Дні важкої генерації	Стеля 25 USD/день по всіх платних рушіях; підніміть її в Settings → Security або через `MAVEN_DAILY_SPEND_USD`.
Проєкти VC-Forge поза вашими домашніми теками	Наявні проєкти працюють далі; нові потрапляють у сховище / `~/Projects` / `~/Documents` / `~/Desktop` / `~/Obsidian` (або `MAVEN_VCFORGE_DIR`).
R-Forge / N-Forge отримували URL `localhost` або з LAN	Тепер відмовляють; `MAVEN_ALLOW_PRIVATE_FETCH=1`, якщо це було навмисно.
Telegram-боти 3D-Forge	Перепрошиваються автоматично. Якщо бот відповідає «hook refused», виконайте `node scripts/gforge/setup-swarm-3d.mjs --all`.
`npm run dev -- -H 0.0.0.0`	Не робіть так. Використовуйте Tailscale / тунель + Settings → Security → Allowed hosts.

Повний довідник: Безпека й віддалений доступ.

Що нового в 6.21.0

SocialHub - власний застосунок M.A.V.E.N для публікацій. Наразі підключаються Telegram і Mastodon; дописи для непідключених платформ ідуть до тестового каналу. Дописи агентів чекають погодження, якщо платформу не позначено як autonomous; є добові ліміти та вимикач. Див. SocialHub.
Content factory і Brands - другий поверх PLAYGROUND: 14 ШІ-ролей, без людей у ланцюжку, профілі брендів, які Claude читає з ваших файлів і сайту. Див. Content factory і Brands.
Відео через S-Forge - контент-фабрика знімає відео як фільми через S-Forge, із жорстким лімітом кредитів.
Бічна панель - у дев’яти застосунків (Ad-, D-, G-, M-, N-, P-, R-, T- і X-Forge) замість підзаголовка показувався сирий ключ; виправлено в EN, UK і RU.
Виправлення рушія PLAYGROUND - повтор прогону, що зупиняється, відхиляється, доки не завершиться його крок (раніше його мовчки ігнорували); файл, який крок лише читає, більше не вважається його результатом; рев’юери можуть запускати ffmpeg/ffprobe, щоб зазирнути всередину відео.
Також від 6.18.5: реальні прогони PLAYGROUND (6.19.0), виправлення збірки й озвучення Course Studio (6.20.1), виправлення профілю Hermes «default» та односторонній бекап налаштувань на GitHub. Релізу 6.20.0 не було.

Нотатки до старіших версій

Перестрибуєте кілька версій за раз? Виконайте загальну процедуру один раз до цільової версії, а потім прочитайте проміжні нотатки в UPDATE.md у репозиторії. Ті, що досі кусаються:

6.12.5-6.12.7 → новіша - старий оновлювач спотикався на .next/cache під час перейменування. Розірвіть петлю один раз: cd ~/maven && rm -rf .next/cache && node scripts/self-update.mjs, або вручну git pull && npm install && npm run build.
≤ 6.5 → новіша - Course Gen і Maven-Slides стали P-Forge; /coursegen і /slides перенаправляють. /vibecoding перенаправляє на VC-Forge, /mineru на D-Forge → MinerU, /seo на SEO-Forge.
≤ 6.13 → новіша - сторінки консолей окремих моделей стали одним Chat; Music, Thumbnails, OpenMontage і Video Editor - це вкладки M-Forge.

Ваші файли зберігаються

Оновлення повертає відстежувані файли до стану релізу, але ваші власні не чіпає: agents.config.json (тристороннє злиття, якщо реліз теж його змінив), .env.local, усе в ~/.maven, сховище та входи в CLI.