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