refactor(repo): reorganize repository structure for improved navigation and maintainability

Implement comprehensive directory reorganization to improve discoverability, logical grouping, and separation of concerns across documentation, scripts, and infrastructure snapshots. Major Changes: 1. Documentation Reorganization: - Created start-here-docs/ for onboarding documentation * Moved QUICK-START.md, START-HERE.md, GIT-SETUP-GUIDE.md * Moved GIT-QUICK-REFERENCE.md, SCRIPT-USAGE.md, SETUP-COMPLETE.md - Created troubleshooting/ directory * Moved BUGFIX-SUMMARY.md for centralized issue resolution - Created mcp/ directory for Model Context Protocol configurations * Moved OBSIDIAN-MCP-SETUP.md to mcp/obsidian/ 2. Scripts Reorganization: - Created scripts/crawlers-exporters/ for infrastructure collection * Moved collect*.sh scripts and collection documentation * Consolidates Proxmox homelab export tooling - Created scripts/fixers/ for operational repair scripts * Moved fix_n8n_db_*.sh scripts * Isolated scripts with embedded credentials (templates tracked) - Created scripts/qol/ for quality-of-life utilities * Moved git-aliases.sh and git-first-commit.sh 3. Infrastructure Snapshots: - Created disaster-recovery/ for active infrastructure state * Moved latest homelab-export-20251202-204939/ snapshot * Contains current VM/CT configurations and system state - Created archive-homelab/ for historical snapshots * Moved homelab-export-*.tar.gz archives * Preserves point-in-time backups for reference 4. Agent Definitions: - Created sub-agents/ directory * Added backend-builder.md (development agent) * Added lab-operator.md (infrastructure operations agent) * Added librarian.md (git/version control agent) * Added scribe.md (documentation agent) 5. Updated INDEX.md: - Reflects new directory structure throughout - Updated all file path references - Enhanced navigation with new sections - Added agent roles documentation - Updated quick reference commands 6. Security Improvements: - Updated .gitignore to match reorganized file locations - Corrected path for scripts/fixers/fix_n8n_db_c_locale.sh exclusion - Maintained template-based credential management pattern Infrastructure State Update: - Latest snapshot: 2025-12-02 20:49:54 - Removed: VM 101 (gitlab), CT 112 (Anytype) - Added: CT 113 (n8n) - Total: 9 VMs, 3 Containers Impact: - Improved repository navigation and discoverability - Logical separation of documentation, scripts, and snapshots - Clearer onboarding path for new users - Enhanced maintainability through organized structure - Foundation for multi-agent workflow support Files changed: 90 files (+935/-349) - 3 modified, 14 new files, 73 renames/moves 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-02 21:39:33 -07:00
parent eec4c4b298
commit 4f69420aaa
90 changed files with 935 additions and 349 deletions
--- a/disaster-recovery/homelab-export-20251202-204939/exports/guests/all-guests.json
+++ b/disaster-recovery/homelab-export-20251202-204939/exports/guests/all-guests.json
@@ -0,0 +1 @@
+[{"cpu":0.0186187802692886,"disk":0,"diskread":8754925056,"diskwrite":98623840256,"id":"qemu/100","maxcpu":4,"maxdisk":107374182400,"maxmem":8598323200,"mem":8120344576,"name":"docker-hub","netin":10940472600,"netout":433402096,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":5471875,"vmid":100},{"cpu":0.000396373773600793,"disk":756023296,"diskread":56942592,"diskwrite":0,"id":"lxc/102","maxcpu":1,"maxdisk":2147483648,"maxmem":2147483648,"mem":111960064,"name":"nginx","netin":6466499856,"netout":1025651322,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":6223985,"vmid":102},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"lxc/103","maxcpu":2,"maxdisk":4294967296,"maxmem":2147483648,"mem":0,"name":"netbox","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"community-script;network","template":0,"type":"lxc","uptime":0,"vmid":103},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/104","maxcpu":2,"maxdisk":34359738368,"maxmem":5242880000,"mem":0,"name":"ubuntu-dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":104},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/105","maxcpu":4,"maxdisk":34359738368,"maxmem":16777216000,"mem":0,"name":"dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":105},{"cpu":0.0119351155572363,"disk":0,"diskread":20044764516,"diskwrite":44196287488,"id":"qemu/106","maxcpu":2,"maxdisk":34359738368,"maxmem":4294967296,"mem":3740889088,"name":"Ansible-Control","netin":8096426464,"netout":77216446,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2712783,"vmid":106},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/107","maxcpu":2,"maxdisk":53687091200,"maxmem":4294967296,"mem":0,"name":"ubuntu-docker","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":107},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/108","maxcpu":4,"maxdisk":107374182400,"maxmem":33554432000,"mem":0,"name":"CML","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":108},{"cpu":0.0267346588482093,"disk":0,"diskread":572292626,"diskwrite":1008925696,"id":"qemu/109","maxcpu":1,"maxdisk":34359738368,"maxmem":2147483648,"mem":209444864,"name":"web-server-01","netin":4917325955,"netout":3941494,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2697866,"vmid":109},{"cpu":0.00286442773373671,"disk":0,"diskread":5130442360,"diskwrite":21638929920,"id":"qemu/110","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2422759424,"name":"web-server-02","netin":6548218322,"netout":24100161,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2692908,"vmid":110},{"cpu":0.00381923697831561,"disk":0,"diskread":4973196920,"diskwrite":22098824704,"id":"qemu/111","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2348294144,"name":"db-server-01","netin":6556023366,"netout":20880204,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2691971,"vmid":111},{"cpu":0.000396373773600793,"disk":2294022144,"diskread":0,"diskwrite":114688,"id":"lxc/113","maxcpu":2,"maxdisk":21474836480,"maxmem":4294967296,"mem":498909184,"name":"n8n","netin":1092664063,"netout":20852346,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":201537,"vmid":113}]
				`@@ -0,0 +1 @@`
				[{"cpu":0.0186187802692886,"disk":0,"diskread":8754925056,"diskwrite":98623840256,"id":"qemu/100","maxcpu":4,"maxdisk":107374182400,"maxmem":8598323200,"mem":8120344576,"name":"docker-hub","netin":10940472600,"netout":433402096,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":5471875,"vmid":100},{"cpu":0.000396373773600793,"disk":756023296,"diskread":56942592,"diskwrite":0,"id":"lxc/102","maxcpu":1,"maxdisk":2147483648,"maxmem":2147483648,"mem":111960064,"name":"nginx","netin":6466499856,"netout":1025651322,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":6223985,"vmid":102},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"lxc/103","maxcpu":2,"maxdisk":4294967296,"maxmem":2147483648,"mem":0,"name":"netbox","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"community-script;network","template":0,"type":"lxc","uptime":0,"vmid":103},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/104","maxcpu":2,"maxdisk":34359738368,"maxmem":5242880000,"mem":0,"name":"ubuntu-dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":104},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/105","maxcpu":4,"maxdisk":34359738368,"maxmem":16777216000,"mem":0,"name":"dev","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":105},{"cpu":0.0119351155572363,"disk":0,"diskread":20044764516,"diskwrite":44196287488,"id":"qemu/106","maxcpu":2,"maxdisk":34359738368,"maxmem":4294967296,"mem":3740889088,"name":"Ansible-Control","netin":8096426464,"netout":77216446,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2712783,"vmid":106},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/107","maxcpu":2,"maxdisk":53687091200,"maxmem":4294967296,"mem":0,"name":"ubuntu-docker","netin":0,"netout":0,"node":"serviceslab","status":"stopped","tags":"template","template":1,"type":"qemu","uptime":0,"vmid":107},{"cpu":0,"disk":0,"diskread":0,"diskwrite":0,"id":"qemu/108","maxcpu":4,"maxdisk":107374182400,"maxmem":33554432000,"mem":0,"name":"CML","netin":0,"netout":0,"node":"serviceslab","status":"stopped","template":0,"type":"qemu","uptime":0,"vmid":108},{"cpu":0.0267346588482093,"disk":0,"diskread":572292626,"diskwrite":1008925696,"id":"qemu/109","maxcpu":1,"maxdisk":34359738368,"maxmem":2147483648,"mem":209444864,"name":"web-server-01","netin":4917325955,"netout":3941494,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2697866,"vmid":109},{"cpu":0.00286442773373671,"disk":0,"diskread":5130442360,"diskwrite":21638929920,"id":"qemu/110","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2422759424,"name":"web-server-02","netin":6548218322,"netout":24100161,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2692908,"vmid":110},{"cpu":0.00381923697831561,"disk":0,"diskread":4973196920,"diskwrite":22098824704,"id":"qemu/111","maxcpu":1,"maxdisk":34359738368,"maxmem":4294967296,"mem":2348294144,"name":"db-server-01","netin":6556023366,"netout":20880204,"node":"serviceslab","status":"running","template":0,"type":"qemu","uptime":2691971,"vmid":111},{"cpu":0.000396373773600793,"disk":2294022144,"diskread":0,"diskwrite":114688,"id":"lxc/113","maxcpu":2,"maxdisk":21474836480,"maxmem":4294967296,"mem":498909184,"name":"n8n","netin":1092664063,"netout":20852346,"node":"serviceslab","status":"running","template":0,"type":"lxc","uptime":201537,"vmid":113}]