Newer
Older
gnexus-book / 90-maintenance / pending-changes / 20260904235055-e4ef9b19.json
{
  "id": "20260904235055-e4ef9b19",
  "kind": "doc",
  "target": "10-systems/applications/gnexus-book.md",
  "summary": "Correct gnexus-book deployment facts: VM gnbook 192.168.1.170, repo /home/ubuntu/gnexus-book, endpoints 8000/8001/80, user-level systemd services",
  "reason": "Live SSH verification on gnbook VM (192.168.1.170): repo path is /home/ubuntu/gnexus-book, not /home/gmikcon/Projects/gnexus-book; endpoints 8000/8001/80 verified; services are user-level systemd units.",
  "payload": {
    "content": "---\nowner: gmikcon\nstatus: active\nlast_reviewed: 2026-09-05\nreview_interval: 30d\nconfidence: high\nsource_of_truth: ssh-host-verified\n---\n\n# Gnexus Book\n\nGnexus Book is the canonical infrastructure knowledge base and maintenance API for the personal digital and server infrastructure.\n\n## Deployment\n\n- Runs as KVM VM `gnbook` (192.168.1.170) on hypervisor `hp-proliant-dl380-g6` (192.168.1.130).\n- SSH: `ubuntu` on 192.168.1.170 (credentials in gnexus-creds, secret `gnauth-gnbook-ssh`).\n- Repository path: `/home/ubuntu/gnexus-book` (branch `master`).\n- Source of truth: Markdown, YAML inventory, JSON Schema, and Git history.\n\n## Runtime Components\n\n- Backend: FastAPI under `server/`.\n- Agent interface: MCP server under `server/app/mcp_server.py`.\n- UI: Vue/Vite under `ui/`.\n- UI dependency: `gnexus-ui-kit`.\n\n## Endpoints\n\n- REST API: `http://192.168.1.170:8000/` (uvicorn, openapi at `/openapi.json`).\n- MCP (SSE): `http://192.168.1.170:8001/sse`.\n- UI (LAN): `http://192.168.1.170:80/` (nginx serves the built SPA).\n- Services run as user-level systemd units under `user@1000.service`: `gnexus-book-backend.service` (uvicorn :8000) and `gnexus-book-mcp.service` (MCP server).\n\n## Maintenance Model\n\nAgents should prefer structured inventory changes, validation, pending changes, and local commits through the maintenance API.\n\nPending-change queue lives in `90-maintenance/pending-changes/` (untracked JSON files; 11 older ones are git-tracked). Repository-wide validation scans every pending JSON, so a single invalid pending file blocks all applies and commits.\n\nFor agent-facing MCP usage rules, see [../../90-maintenance/agent-mcp-usage.md](../../90-maintenance/agent-mcp-usage.md).\n\nNo raw credentials are documented here."
  },
  "status": "applied",
  "created_at": "2026-09-04T23:50:55Z",
  "updated_at": "2026-09-04T23:50:56Z",
  "applied_at": "2026-09-04T23:50:56Z",
  "validation": {
    "status": "ok",
    "issue_count": 0,
    "issues": []
  }
}