diff --git a/10-systems/applications/gnexus-book.md b/10-systems/applications/gnexus-book.md index 799a8cf..369a810 100644 --- a/10-systems/applications/gnexus-book.md +++ b/10-systems/applications/gnexus-book.md @@ -1,19 +1,21 @@ --- owner: gmikcon status: active -last_reviewed: 2026-05-10 +last_reviewed: 2026-09-05 review_interval: 30d confidence: high -source_of_truth: repository +source_of_truth: ssh-host-verified --- # Gnexus Book Gnexus Book is the canonical infrastructure knowledge base and maintenance API for the personal digital and server infrastructure. -## Repository +## Deployment -- Local path: `/home/gmikcon/Projects/gnexus-book`. +- Runs as KVM VM `gnbook` (192.168.1.170) on hypervisor `hp-proliant-dl380-g6` (192.168.1.130). +- SSH: `ubuntu` on 192.168.1.170 (credentials in gnexus-creds, secret `gnauth-gnbook-ssh`). +- Repository path: `/home/ubuntu/gnexus-book` (branch `master`). - Source of truth: Markdown, YAML inventory, JSON Schema, and Git history. ## Runtime Components @@ -23,17 +25,19 @@ - UI: Vue/Vite under `ui/`. - UI dependency: `gnexus-ui-kit`. -## Current Local Endpoints +## Endpoints -- Backend API: `http://127.0.0.1:3005/`. -- API docs: `http://127.0.0.1:3005/api-docs`. -- UI: `http://127.0.0.1:3006/`. -- LAN UI: `http://192.168.1.75:3006/`. +- REST API: `http://192.168.1.170:8000/` (uvicorn, openapi at `/openapi.json`). +- MCP (SSE): `http://192.168.1.170:8001/sse`. +- UI (LAN): `http://192.168.1.170:80/` (nginx serves the built SPA). +- Services run as user-level systemd units under `user@1000.service`: `gnexus-book-backend.service` (uvicorn :8000) and `gnexus-book-mcp.service` (MCP server). ## Maintenance Model Agents should prefer structured inventory changes, validation, pending changes, and local commits through the maintenance API. +Pending-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. + For agent-facing MCP usage rules, see [../../90-maintenance/agent-mcp-usage.md](../../90-maintenance/agent-mcp-usage.md). No raw credentials are documented here. diff --git a/90-maintenance/pending-changes/20260904235055-e4ef9b19.json b/90-maintenance/pending-changes/20260904235055-e4ef9b19.json new file mode 100644 index 0000000..7f7c5d2 --- /dev/null +++ b/90-maintenance/pending-changes/20260904235055-e4ef9b19.json @@ -0,0 +1,19 @@ +{ + "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": [] + } +}