gnexus-book / 90-maintenance / pending-changes /
..
20260514205719-5bcfb1b9.json Add light control action reference (bedroom/hallway) to smart-home-overview.md with frontmatter. 6 months ago
20260514210203-5b95e09f.json Add API usage instructions for triggering ControlScripts actions to smart-to-home-server.md with frontmatter. 6 months ago
20260514210418-3b67bb0b.json Add light control action reference (bedroom/hallway) to smart-home-overview.md 6 months ago
20260904105837-12fb622e.json Document file-based GAuth OAuth state/PKCE stores applied on 2026-09-04 2 months ago
20260904162939-344949c4.json Add verified modes system, device/channel inventory, device API auth, sensor capabilities, and empty-subsystem facts to smart-home overview 2 months ago
20260904162948-47c0637e.json Fix dead action aliases in API examples; add live-alias warning 2 months ago
20260904162955-62505a52.json Replace dead alias master_room_lamp_switcher with live master_toggle in bedroom light procedure 2 months ago
20260904174036-1711f5fe.json Tier 1 deployed: GlobalScenesScope with 7 scene actions; live actions 18→25; all-lights-off gap resolved; scope-gate two-pass activation documented; DB counters corrected (45 action / 14 scope rows). 2 months ago
20260904184827-b323a52e.json Add exact POST /action wire format for relay devices (live-verified on light_hub_1): mandatory action field, allowed actions set_state/set_channel_state/toggle_channel, 400 without action. 2 months ago
20260904190029-9dc56129.json Add smart-home control playbook: owner rule (no direct device control by default), 4-path hierarchy (CLI action, HTTP API, temp script, restricted device API), safety rules, quick reference. 2 months ago
20260904235055-e4ef9b19.json Correct gnexus-book deployment facts: VM gnbook 192.168.1.170, repo /home/ubuntu/gnexus-book, endpoints 8000/8001/80, user-level systemd services 2 months ago
20260910014153-a22e16c5.json Enrich tgbots host doc: hostname vmk, credentials reference, marginator docker-compose stack details 2 months ago
20260910014812-1bb8f112.json Add 2026-09-10 audit note to tgbots host doc: no Telegram bot currently deployed on the host. 2 months ago
20260910015945-2ccf303c.json MardisBot is ACTIVE on VM tg_bots (192.168.1.254); correct host and status 2 months ago
20260910073239-2f4c8088.json MardisOpsBot v2 deployed: /backup + ZIP-update, sudoers stop/start, unit ReadWritePaths; tests 18/18 2 months ago
20260910200746-66475273.json Отключён GHARD_ADMIN_TOKEN (UI не работает с токеном), исправлен compose-дефолт, добавлены MCP и заметки 2 months ago
20260910203903-3bc8be2d.json Fleet hard-monitor: 18/18 серверов online, метод деплоя и грабли 2 months ago
20260911073052-59764fb0.json Мониторинг NFS-шар: 4 шары online, руководство по добавлению 2 months ago
20260912155435-5b1b55bb.json MardisBot: poll schedule moved to Wed+Fri 19:00 Kyiv, PYTHONUNBUFFERED added to unit, backups documented 2 months ago
20260916163354-51ab4e24.json Add 2026-09-16 Ollama key rotation maintenance note to navi-zoe doc 2 months ago
20260917172133-248a821b.json Document navi-1 (tsukiko) deployment on bugtrail: repo path, service, ports, hive, instance id 2 months ago
20260919180804-a7ac7433.json Add VM disk layout and free-space observation for gitbucket VM (2026-09-19) 2 months ago
20260919180826-414c9027.json Fix radio repo last-commit year typo (2026-02-23 -> 2025-02-23) 2 months ago
20260919194456-8c1e159a.json Create host doc for VM gitbucket: GitBucket + navi instance pilar (deployed 2026-09-19) 2 months ago
20260919194506-0559c3a4.json Add hosts inventory item for VM gitbucket (GitBucket + navi pilar) 2 months ago
20260919194523-2357bc1c.json Update gitbucket VM inventory: runs navi instance pilar 2 months ago
20260921203531-247a407b.json Добавлен сайт tasks.gnexus.space (upstream 192.168.1.179:8135) и отдельный certbot-сертификат (до 2026-12-20) 2 months ago
20260921203546-7e86f8f6.json Добавлена секция gntodo (GNexus Tasks): стек на :8135, SSO pending, Ollama .130/qwen3.5:2b 2 months ago
20260921205714-15bd34ce.json SSO настроен: client_id/secret в .env, api пересоздан, креды в gnexus-creds (ca8836f7) 2 months ago
20260921231950-9f84fb3f.json gntodo обновлён до ac8aefb: мультитенантность, вебхуки SSO, per-user MCP-токены; GAUTH_WEBHOOK_SECRET настроен, бэкап снят 2 months ago
20260921232657-16baab8a.json Webhook secret ротирован (whsec_kgL...), подписанный тест пройден: новый 200, старый 400 2 months ago
20260922102949-064c401d.json gntranscribe: задокументирован инцидент 2026-09-22 — «Timed out» был таймаутом Telegram API, не whisper; добавлено правило триажа 1 month ago
20260922103500-722ba7f7.json gntranscribe: фикс применён — except TimedOut + PTB таймауты 30s, бэкап bot.py.bak-20260922, сервис перезапущен и верифицирован 1 month ago
20260922104010-9e5f1330.json tgbots.md: добавлена заметка «do not confuse» со ссылкой на новую доку tgbots-vm (192.168.1.254), где живут боты 1 month ago
20260924054348-7f5637f4.json Document poisoned-pending protection: validate-before-write, full rollback on failed apply, delete_pending_change tool, corrupt-JSON tolerance 1 month ago
20260924200548-a2b3fbd1.json Add 2026-09-24 second deploy (af9d3f9) to gnauth deployment history 1 month ago
20260929165538-3933b022.json S10e node doc: add Termux (SSH 8022, packages, sshd gotchas) and notifications (dumpsys read, notif-watcher, test-post) sections; fix settings values 1 month ago
20260929165549-c525407d.json gprint doc: add notif-watcher service, Termux SSH access section, README size, sudo -S gotcha 1 month ago
20260929173055-1505bd2b.json S10e node doc: add ADBKeyboard text-input section (Cyrillic via ADB_INPUT_B64, IME switch/restore, verified TG send) 1 month ago
20260929191953-a9c3f690.json Document pfSense SSH key location on gmikcon PC and ai_agent_ro log-read limitations 1 month ago
20260929201130-b8608098.json Document transmission VM: Flood UI :3000, transmission RPC :9091, NFS mounts (firstraid5/secraid5/NetTera8), SSH access, RPC add-torrent procedure. 1 month ago
20260930080624-12d193c4.json gntodo updated 2026-09-30: dcb6976 → b8ee805 (UI kit 1.0.0, achievements popover, garden rebalance ×2, iOS Safari fixes); full rebuild, no migrations, backup gntodo-pre-update-20260930-075743 1 month ago
20260930080631-5a2c42c8.json gntodo inventory: updated to b8ee805, last_reviewed 2026-09-30 1 month ago
20260930084007-bfc6c132.json gntodo updated 2026-09-30 #2: b8ee805 → 6ca1491 (image paste, kit 1.0.0 branding, popup drafts, extension restyle); web rebuild incl. extension ZIP, api untouched 1 month ago
20260930190255-e617a0cb.json Update NetTera8 free space, document Gentlemen S2 torrent added to serials, add torrent-rename-path step 1 month ago
20260930205009-f850bdbf.json Transmission VM: добавлена закачка Кобры 1986 (rutor 780564) в secraid5_storage/films и gotcha про зависание magnet-only добавлений 1 month ago
20260930205451-da215198.json transmission.md: добавлена секция про helper-скрипт add-torrent.py (деплой, usage, логика, exit-коды, тесты) 1 month ago
20261001192159-3b700379.json gnexus-creds updated to 4c6a4f7 (2026-10-01): documented local compose adaptation, update procedure, SSH access 1 month ago
20261002094809-994c2829.json gnexus-creds updated to 02a2441 (2026-10-02): localization, mobile UX, extension design pack 1 month ago
20261002095713-4c4738e8.json gnexus-creds updated to 3b5a00d (2026-10-02): extension 0.2.0 builds on download page 1 month ago
20261002113825-1c908d37.json gnexus-creds updated to 543d6ae (2026-10-02): splash on sign-in, extension 0.2.1 1 month ago
20261002114916-a744ced2.json gnexus-creds: documented MCP/UI visibility semantics after false data-loss alarm 1 month ago
20261002115531-1efad84f.json Add audit semantics section: snapshots persist after delete/rename, archived secrets stay in DB, audit IP is the internal proxy 1 month ago
20261002120252-58599fa8.json Add users section (2 accounts, all secrets owned by goldmikki), correct secret counts to 71 (69+2, 20/49 allow_mcp) 1 month ago
20261002121832-c039922c.json Add Backups section: daily pg_dump + .env snapshot, 10-day retention, root crontab 04:00 UTC; note extension secrets use source=domain and REST channel 1 month ago
20261002203231-e68a5988.json Version 27f95b4, extension 0.2.2 + pack v24; add Extension deployment section (zips committed in repo, no host rebuild); update procedure note about migrations 1 month ago
20261002210209-f31bbcfb.json Version 287b7a0 (session death → sign-in without reload); update procedure count ×5 1 month ago
20261002212055-ac892a3e.json Add token revocation semantics: revocation immediate, extension popup cache TTL 5min can look alive, session-cookie fallthrough for same-browser requests 1 month ago
20261002213620-2f131bac.json Version 53acfb4 (Bearer fails closed); revocation semantics updated; extension rebuild recipe via node container; update count ×6 1 month ago
20261003102605-bcc028f6.json Version 8a4814a: crypto migration done (salted KDF + AAD), alembic 0002, extension 0.2.4, new env vars (salt, CORS), update count ×7 1 month ago
20261003172610-05a88bf5.json pfSense: friend router = Archer C6 (no VPN on stock, OpenWrt possible); SSH-proxy approach chosen; WG readiness verified 1 month ago
20261003174337-d1fa1713.json pfSense: correct C6 stock VPN facts — C6 v2 supports OpenVPN server per official TP-Link FAQ 1 month ago
20261005000324-96972db9.json Add hpanel.gnexus.space route to internal nginx proxy targets (GHard panel, TLS, /mcp blocked) 1 month ago
20261005002114-4dd8dfca.json hard-panel: панель закрыта за gnexus-auth (OAuth PKCE), allowlist владельца, верификация ok 1 month ago
20261005013547-df4028a8.json Update 2026-10-05 04:35: стек обновлён 0ba611c..2f6d8d4 (admin-сводка + мобильная адаптация), миграций нет, бэкап 28 KB, все health-проверки пройдены 1 month ago
20261005020956-1c9eb8ee.json hard-panel: обновление 40a8810..c11cd47 — PWA и MCP-тулы управления; бэкап БД на хост; флот 19/19 1 month ago
20261005083059-3d6486d3.json hard-panel: обновление c11cd47..3867b9d — фикс maskable PWA-иконок; бэкап БД файловым копированием (sqlite3 в контейнере нет), флот 19/19, шары 4/4, сервисы 6/6, MCP initialize OK 1 month ago
20261005091444-6c8aeade.json hard-panel: обновление 3867b9d..9b41caf — favicon сервисов (service_meta.py, ttl 24ч) и фиксы сеток на мобиле; бэкап БД 1.6G+wal/shm, флот 19/19, шары 4/4, сервисы 6/6, MCP initialize OK 1 month ago
20261005170843-a2ab81dd.json Add Piper TTS section to gprint host doc (binary, irina voice, usage, performance) 1 month ago
20261005215712-42e7e805.json tgclientmcp: фикс #4 (client.session) + заметки по доставке кода 1 month ago
20261005221801-69f7435e.json tgclientmcp: фича #5 автоотмена логинов (sweeper) + заметки 1 month ago
20261006201248-fedb6ab0.json tgclient-mcp обновлён до edbd2e2 (QR-вход); деплой-фиксы закоммичены в репо; docker compose требует sudo; health ok после обновления. 1 month ago
20261006205454-26f83213.json tgclient-mcp обновлён до f4b1da9 (wait_for отмены, живые pending-логины, ревью логина, тесты); health ok. 1 month ago
20261006210633-9bade79c.json Аккаунт владельца залогинен через QR (sukhodolskiy, active); pending по логину закрыт; замечен TypeError от auth.cancelCode. 1 month ago
20261006212206-0961e088.json tgclient-mcp обновлён до 0fc015e (SPA-табы логин-визарда); health ok. 1 month ago
20261006215917-df04ba26.json tgclient-mcp обновлён до ac8b764 (SPA-фиксы disconnect-иконки и инпута ключа); health ok. 1 month ago
20261007143928-d333f5ed.json tgclient-mcp обновлён до 5cc14e3 (MCP runtime-аудит тулов + тесты); health ok. 1 month ago
20261007150805-1da4beb7.json Add nextcloud VM host doc: identity, cloud.gnexus.space upstream role, 2026-10-06 OOM crash incident. 1 month ago
20261007150811-d73369b6.json Add nextcloud VM (192.168.1.152) to hosts inventory 1 month ago
20261007151146-26215457.json Document vanilla Minecraft server on mine: systemd unit, screen/RCON access, Restart gotcha, 2026-10-07 stop, dead .218 proxy mapping. 1 month ago
20261007175519-da619452.json Узел Moto g54: SIM PIN отключён (PUK-история), сенсор отключить нельзя (проверено), TG Navi залогинен, S10e — личный телефон владельца 1 month ago
20261007175557-7ac2d068.json S10e: SIM владельца в слоте 1, узловая SIM переехала в Motorola, TG владельца активен — не трогать узловые скрипты 1 month ago
20261007190511-a5e925d3.json Synapse: s2s-доставка в Navi rei настроена и проверена E2E (delivered → реакция) 1 month ago
20261007193107-876b15dc.json Synapse: e2e message/received после фикса _touch пройден (тест 2 delivered, тест 1 отсутствовал до фикса); добавлен риск петли правила tgclient→navi-rei в Pending 1 month ago
20261007204346-172b388e.json hard-panel: Synapse reporter включён (GHARD_SYNAPSE_* в .env, source/типы/ключ/правило в Synapse, E2E в navi-rei подтверждён) 1 month ago
20261007204425-f3fc4939.json gnexus-synapse: источник hard-panel подключён (source id 3, 11 типов, ключ, правило → s2s navi-rei, E2E подтверждена) 1 month ago
20261007211620-8ddeefa7.json jellyfin.md: добавлен panel id 39 и заметка о транзиентном RAM-всплеске 2026-10-07 21:11 UTC (самовосстановление за ~90 с) 1 month ago
20261008114137-432b8ad5.json internal-proxy: ребут 2026-10-08 (чистый ACPI shutdown 11:24:20 UTC), recreate navi-postgres — следствие, сервисы восстановлены; побочные наблюдения и открытый вопрос по инициатору (gntodo 455) 1 month ago
20261008114201-89614206.json internal-proxy: фикс опечаток предыдущего коммита (CN bugtrail, дубль SSH access) 1 month ago
20261008212410-8de03f89.json jellyfin: подтверждён ежедневный OOM-цикл (второй инцидент 2026-10-08), добавлена проверенная процедура очистки swap, уточнён процесс-виновник (trickplay ffmpeg) 1 month ago
20261008213150-aa56e649.json jellyfin: root cause OOM-цикла найден (Trickplay task), применены cgroup-лимиты 8G/10G, задача остановлена и переведена на ручной запуск 1 month ago
20261009094609-1b509d3c.json gnexus-book: добавлен раздел Backups — ежедневный cron 03:10 UTC, tar.gz всего репо + git bundle, ротация 10 дней, sanity-проверки, restore-набросок 1 month ago
20261009171513-fb57e605.json Synapse: обновление до 5531f71 (MCP settings_get fix, без миграций) + ежедневный бекап с ротацией 10 копий (скрипт + cron 04:20 Kyiv) 1 month ago
20261009231926-e4422e49.json gntodo updated to 6ddbcef (2026-10-09) + daily automated backups with 10-day rotation documented 1 month ago
20261009231940-87e58455.json gntodo inventory: last_reviewed 2026-10-09 + daily backup automation 1 month ago
20261010062833-af5cf1c8.json 2026-10-10: будильники Google Clock на Moto g54 отключены (force-stop + pm disable-user), следующий будильник 2026-10-11 07:54 снят, проверено через dumpsys alarm 1 month ago
20261010120038-aea7096f.json Add 2026-10-10 AudioNormalization incident (web UI freeze, DSD256 ebur128 analysis), fix steps, trigger-persistence warning, API POST note; update fixes status 1 month ago
20261010120807-13b33b1e.json Update 2026-10-10: rebuild panel container on current image (stale-image pitfall after force-recreate), add jellyfin service #7 to health checker, tools/list now 10 tools 1 month ago
20261010120824-e3f60f28.json Monitoring section: jellyfin now health-checked on the panel as service id 7; follow-up note in incident section 1 month ago
20261010172134-78ddea64.json gntodo updated 2026-10-10: 6ddbcef → 94af80e (agent mandate, Web Push, reminders), 3 additive migrations, full rebuild verified 1 month ago
20261010182239-4a7599ee.json hard-panel: обновление 9b41caf..f14fb26 — разряжение истории, дайджест бакета, VACUUM (БД 2.0 GB → 221 MB), нюанс первого старта ~7 мин 1 month ago
20261010182923-29342548.json gntodo: Web Push включён — VAPID-ключи сгенерированы, .env + локальная правка compose (проброс в api), push_enabled=True, креды в gnexus-creds 1 month ago
20261010191624-69a9fe38.json gntodo: Update 2026-10-10 #2 (94af80e → 4837d28) — BugTrail-импорт (ТЗ 3.22) + автодетализация 0.93, full rebuild, без миграций, VAPID-правка compose пережила pull 1 month ago
20261010205524-b77faea8.json gntodo: обновление 4837d28 → 8351f09 (0.94 мобильные фиксы журнала/списка, 0.95 стек входящих, 0.96 прозрачные углы иконок) — full rebuild, без миграций, VAPID-правка compose сохранена 1 month ago
20261010235815-b6292d90.json Tesla 4K ATV2: документ управления tv.sh (макросы on/off/jellyfin/youtube/media), статика .190, особенности платформы 1 month ago
20261011000022-af76c172.json tv.sh: постоянный путь /usr/local/lib/navi/tv.sh + симлинк /usr/local/bin/tv, workspace — рабочая копия 1 month ago
20261011001250-fe6ab0c2.json Tesla 4K ATV2: чистка хранилища (166→~900МБ), OTA нет, автообновления off, 15 UK-пакетов удалено, 21 отключён 1 month ago
20261011090212-99905c75.json health-чекер: добавлен сервис #8 nextcloud (https://cloud.gnexus.space/status.php), сервисы 8/8 up 1 month ago
20261011091335-d06dbc91.json Nextcloud: MySQL buffer pool 4G + flush 2, APCu memcache.local; замеры до/после 1 month ago
20261011101133-cee9a29f.json Добавлен инцидент 2026-10-11 (обновление 29→30, 503 в maintenance mode, 500 из-за opcache после апгрейда, фикс рестартом apache2) и правило ранбука: рестарт apache2 после каждого occ upgrade. 1 month ago
20261011104112-6d0cbf71.json Nextcloud major upgrade 27.1.6 → 31.0.14 documented: route, recognize incident on 30→31, app versions, disk state, PHP 8.1 constraint 1 month ago
20261011134337-e78eda39.json Инвентарь 3D-принтеров: Ender 3 V2 (исправление модели) и LAN-доступ Bambu A1 1 month ago
20261011134341-34c25409.json Инвентарь 3D-принтеров: Ender 3 V2 (исправление модели) и LAN-доступ Bambu A1 1 month ago
20261011134412-87ee1837.json Исправлена модель Klipper-принтера на Ender 3 V2; зафиксированы проверенные сетевые факты A1 (IP, порты, LAN-only) и Ender 3 V2 1 month ago
README.md Add documentation foundation and backend maintenance API 6 months ago
README.md

owner: gmikcon status: active last_reviewed: 2026-05-09 review_interval: 90d confidence: high

source_of_truth: project-policy

Pending Changes

This directory stores proposed documentation changes created through the backend API.

Pending changes are not applied to the canonical documentation automatically.

Current Behavior

  • POST /changes creates a JSON pending-change record.
  • GET /changes lists pending changes.
  • GET /changes/{id} reads a pending change.
  • POST /changes/{id}/apply applies kind=doc and kind=inventory-item changes after full validation.

Inventory item apply supports:

  • updating an existing item by id with payload.mode: "update";
  • creating a new item with payload.mode: "create".

Replacing full inventory files is not implemented yet.

Purpose

Pending changes provide a reviewable buffer between AI-agent proposals and canonical documentation updates.

The later apply workflow should be:

pending change
  -> apply to canonical Markdown or inventory file
  -> run full validation
  -> rollback if validation fails
  -> mark change as applied
  -> create local Git commit through `POST /commit`
  -> owner reviews commit
  -> owner manually pushes when ready

Secrets

Pending changes must follow the same secret policy as canonical documentation. They must not contain raw passwords, tokens, private keys, recovery codes, or session cookies.

Inventory Item Payloads

Update an existing item:

{
  "kind": "inventory-item",
  "target": "virtual-machines/gnauth",
  "summary": "Document gnauth service mapping",
  "payload": {
    "mode": "update",
    "patch": {
      "runs_services": ["gnexus-auth"]
    }
  }
}

Create a new item:

{
  "kind": "inventory-item",
  "target": "virtual-machines/new-vm",
  "summary": "Add new VM",
  "payload": {
    "mode": "create",
    "patch": {
      "name": "new-vm",
      "status": "running",
      "hypervisor_host": "hp-proliant-dl380-g6",
      "virtualization_stack": "kvm-libvirt",
      "docs": "../10-systems/virtualization/libvirt-vms.md",
      "last_reviewed": "2026-05-09"
    }
  }
}