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
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"
    }
  }
}