updated docs

pkgs/homelab-docs/main.nix

@@ -0,0 +1,73 @@
+{writeShellScriptBin}:
+writeShellScriptBin "homelab-generate-docs" ''
+  #!/usr/bin/env bash
+  set -euo pipefail
+
+  # Colors
+  BLUE='\033[0;34m'
+  GREEN='\033[0;32m'
+  YELLOW='\033[1;33m'
+  RED='\033[0;31m'
+  NC='\033[0m'
+
+  info() { echo -e "''${BLUE}$1''${NC}"; }
+  success() { echo -e "''${GREEN}$1''${NC}"; }
+  warn() { echo -e "''${YELLOW}$1''${NC}"; }
+  error() { echo -e "''${RED}$1''${NC}"; }
+
+  # Configuration
+  DOCS_DIR="''${1:-./docs}"
+
+  info "📚 Generating homelab documentation..."
+  echo "   Output directory: $DOCS_DIR"
+  echo
+
+  # Check if we're in a directory with a flake
+  if [[ ! -f flake.nix ]]; then
+      error "No flake.nix found in current directory"
+      echo "Please run this command from your homelab flake directory"
+      exit 1
+  fi
+
+  # Check if colmena is available
+  if ! command -v colmena >/dev/null 2>&1; then
+      error "colmena command not found."
+      echo "Please ensure colmena is available in your environment"
+      exit 1
+  fi
+
+  # Create docs directory
+  mkdir -p "$DOCS_DIR"
+
+  # Generate fleet overview
+  info "  🌐 Generating fleet overview..."
+  homelab-docs-fleet > "$DOCS_DIR/fleet-overview.md"
+
+  # Generate node documentation
+  info "  🖥️  Generating node configurations..."
+  homelab-docs-nodes > "$DOCS_DIR/nodes.md"
+
+  # Generate service documentation
+  info "  ⚙️  Generating service configurations..."
+  homelab-docs-services > "$DOCS_DIR/services.md"
+
+  # Generate current deployment
+  info "  🏠 Generating current deployment..."
+  homelab-docs-deployment > "$DOCS_DIR/current-deployment.md"
+
+  # Generate README
+  info "  📋 Generating README..."
+  homelab-docs-readme > "$DOCS_DIR/README.md"
+
+  success "✅ Documentation generated successfully!"
+  echo
+  echo "Generated files:"
+  echo "  🌐 fleet-overview.md     - Fleet statistics and overview"
+  echo "  🖥️  nodes.md             - Per-node configurations"
+  echo "  ⚙️  services.md          - Service configurations"
+  echo "  🏠 current-deployment.md - Current deployment state"
+  echo "  📋 README.md            - Documentation index"
+  echo
+  echo "💡 Tip: Add these files to your repository and set up GitHub Actions"
+  echo "   to automatically regenerate documentation on changes!"
+''