Development Log - Server-Manager Updates

2026-06-05/06: VPS Infrastructure Audit, Cleanup & Documentation Synchronization

VPS Stack Audit & Obsolete Service Purge: Decommissioned legacy services (n8n and evolution_api) and removed their definitions from the VPS Docker Compose stack and related files.
Redis Cache Restoration: Successfully restored and re-provisioned the redis-cache container to the cfs-infra stack on the VPS.
VPS Cleanup Hardening: Modified vps-cleanup.sh to explicitly prevent the deletion of stopped containers, utilizing safe image and network pruning instead of a global system prune.
Documentation Alignment: Synchronized all architecture and infrastructure documents (vps-status-report.md, vps-backup-overall-concept.md, server-cleanup-and-optimization.md, backup-lifecycle.md, recovery-procedure.md, and data-flow.md) to reflect the actual split-stack layout (cfs-infra vs. cfs-platform) and standardized database technology (MariaDB 10.11 instead of PostgreSQL).
ADR Organization: Renamed duplicate ADR 0003 to 0008-antigravity-persistence-strategy.md and integrated it into the VitePress sidebar.

Safe Prune Pattern: Replaced docker system prune -f with explicit, safe commands: docker image prune -f and docker network prune -f.
Database Standardization: Converted database schema logs, tech stack tables, and environment connection variables from PostgreSQL to MariaDB 10.11 dialect/structure.
VitePress Build Integrity: Verified all internal markdown cross-references and build compilation with VitePress build checks.

Ultimate Local-to-Remote SSH Sync: Re-engineered platform/linux/sync-vps-docs-manually.sh as a local script. It transfers only new/updated Markdown files directly to the VPS in seconds, surgically purges obsolete pages, sanitizes links, and injects custom styles.
Surgical Sidebar Merge: Implemented scripts/sync-sidebar.py to copy the local sidebar config array and inject it directly into the VPS config.mts without overwriting vital portal routing, dark mode logos, or custom redirects.
Paused GitHub Actions Pipeline: Commented out the push trigger in .github/workflows/sync-docs.yml to pause the automatic GHA runs on GitHub, saving Action minutes and eliminating parallel sync conflicts.
Redesigned Agent Workflow: Upgraded .agent/workflows/documentation-workflow.md to establish the exact 5-step agent execution protocol (Commit -> Validate -> VPS Sync -> Push -> Verify).
Get Started Button Fix: Modified index.md to resolve the 404 error on the home page by mapping the Get Started button directly to /01_Strategy/gemini-protocol.

rsync over SSH Integration: Integrated rsync -avz -e "ssh -i $IDENTITY_FILE" for instant, secure delta updates.
Dynamic Next.js Static Serving: Verified that VitePress HTML/JS updates are picked up by Next.js's public binder dynamically on the fly, completely eliminating the need for container rebuilds or portal service restarts.

Unified Hierarchy & Cleanup: Finalized the 01-05 layered architecture and purged all obsolete legacy directories (adrs, infrastructure, etc.) on both local and VPS environments.
Workflow Centralization: Moved all operative workflows to .agent/workflows/ and established symlinks in docs/05_Dev_Experience/ to maintain the VitePress build while ensuring a Single Source of Truth (SSoT).
Sync Pipeline Stabilization: Fixed the sync-docs.yml GitHub Action to correctly mirror the new structure and trigger the automated VitePress build on the cfs-platform.
Workflow Healing: Modernized documentation-workflow.md and git-sync.md to reflect the new automated standards.

Symlink Logic: Implemented ln -s based linking for 05_Dev_Experience to bridge operative and documentation needs.
Cross-Repo Sync: Established a clean sync path to cfs-platform/workspaces/infrastructure/apps/server-management/docs/.
TSConfig Fix: Updated tsconfig.json to include hidden directories (like .vitepress) to resolve TypeScript diagnostic errors.