feat: Add comprehensive health check endpoints with real-time monitoring (#18)

* feat: Implement health monitoring functionality

- Add health check command to CLI for checking the health status of the parity client and its services.
- Introduce health handler with endpoints for basic health, detailed health, readiness, and liveness checks.
- Update Makefile to include versioning information during build.
- Enhance README with comprehensive health monitoring documentation and usage examples.
- Refactor router to handle health check endpoints.

* refactor: streamline variable declaration in health handler

Author: virajbhartiya

Makefile

@@ -50,7 +50,14 @@ deps:
 	go mod download
 
 build: ## Build the application
-	$(GOBUILD) $(BUILD_FLAGS) -o $(BINARY_NAME) ./cmd
+	$(eval VERSION := $(shell git describe --tags --always --dirty))
+	$(eval COMMIT := $(shell git rev-parse HEAD))
+	$(eval BUILD_TIME := $(shell date -u '+%Y-%m-%d_%H:%M:%S'))
+	$(GOBUILD) $(BUILD_FLAGS) \
+		-ldflags "-X github.com/theblitlabs/parity-client/internal/version.Version=$(VERSION) \
+		-X github.com/theblitlabs/parity-client/internal/version.CommitSHA=$(COMMIT) \
+		-X github.com/theblitlabs/parity-client/internal/version.BuildTime=$(BUILD_TIME)" \
+		-o $(BINARY_NAME) ./cmd
 	chmod +x $(BINARY_NAME)
 
 test: setup-coverage ## Run tests with coverage
@@ -73,6 +80,9 @@ balance:  ## Check token balances
 auth:  ## Authenticate with the network
 	$(GOCMD) run $(MAIN_PATH) auth
 
+health:  ## Check health status
+	$(GOCMD) run $(MAIN_PATH) health
+
 clean: ## Clean build files
 	rm -f $(BINARY_NAME)
 	find . -type f -name '*.test' -delete

README.md

@@ -361,6 +361,111 @@ curl -X POST http://localhost:3000/api/tasks \
   }'
 ```
 
+### Health Monitoring
+
+The parity client provides comprehensive health monitoring endpoints for operational visibility:
+
+#### Basic Health Check
+
+```bash
+# Command line health check
+parity-client health
+
+# HTTP health check
+curl http://localhost:3000/health
+```
+
+#### Detailed Health Information
+
+```bash
+# Get detailed health status
+parity-client health --detailed
+
+# HTTP detailed health check
+curl http://localhost:3000/health/detailed
+```
+
+#### Kubernetes-style Probes
+
+```bash
+# Readiness probe (for Kubernetes deployments)
+curl http://localhost:3000/health/ready
+
+# Liveness probe (for Kubernetes deployments)
+curl http://localhost:3000/health/live
+```
+
+#### Health Check Options
+
+```bash
+# Check health with custom endpoint
+parity-client health --endpoint http://your-server:8080
+
+# Set custom timeout
+parity-client health --timeout 30s
+
+# Get detailed information
+parity-client health --detailed
+```
+
+#### Health Check Response Format
+
+Basic health check response:
+```json
+{
+  "status": "healthy",
+  "timestamp": "2024-01-15T10:30:00Z",
+  "version": "v1.0.0",
+  "uptime": "2h30m15s",
+  "services": {
+    "blockchain": "configured",
+    "ipfs": "configured",
+    "runner": "configured"
+  }
+}
+```
+
+Detailed health check response:
+```json
+{
+  "status": "healthy",
+  "timestamp": "2024-01-15T10:30:00Z",
+  "version": "v1.0.0",
+  "uptime": "2h30m15s",
+  "services": {
+    "blockchain": {
+      "status": "healthy",
+      "last_check": "2024-01-15T10:29:55Z",
+      "latency": "125ms"
+    },
+    "ipfs": {
+      "status": "healthy",
+      "last_check": "2024-01-15T10:29:58Z",
+      "latency": "45ms"
+    },
+    "runner": {
+      "status": "healthy",
+      "last_check": "2024-01-15T10:30:00Z",
+      "latency": "78ms"
+    }
+  },
+  "config": {
+    "server_host": "0.0.0.0",
+    "server_port": 3000,
+    "blockchain_rpc": "https://your-blockchain-node.com",
+    "ipfs_endpoint": "http://localhost:5001",
+    "runner_url": "http://localhost:8080"
+  }
+}
+```
+
+**Note**: All health check data is real-time:
+- **Uptime**: Actual application uptime since start
+- **Version**: Real version from git tags and build info
+- **Service Status**: Live connectivity tests to blockchain, IPFS, and runner services
+- **Latency**: Actual response times from service health checks
+- **Configuration**: Real configuration values from your environment
+
 ## Configuration Files
 
 ### Model Configuration Examples
@@ -469,10 +574,12 @@ parity-client fl create-session \
 
 ### Health & Status Endpoints
 
-| Method | Endpoint    | Description   |
-| ------ | ----------- | ------------- |
-| GET    | /api/health | Health check  |
-| GET    | /api/status | System status |
+| Method | Endpoint           | Description                    |
+| ------ | ------------------ | ------------------------------ |
+| GET    | /health            | Basic health check             |
+| GET    | /health/detailed   | Detailed health information    |
+| GET    | /health/ready      | Readiness probe                |
+| GET    | /health/live       | Liveness probe                 |
 
 ## Development
 

internal/commands/commands.go

@@ -9,5 +9,6 @@ func AddCommands(rootCmd *cobra.Command) {
 	rootCmd.AddCommand(llmCmd)
 	rootCmd.AddCommand(flCmd)
 	rootCmd.AddCommand(storageCmd)
+	rootCmd.AddCommand(healthCmd)
 	rootCmd.AddCommand(GetReputationCommand())
 }

internal/commands/health.go

@@ -0,0 +1,86 @@
+package commands
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"time"
+
+	"github.com/spf13/cobra"
+	"github.com/theblitlabs/gologger"
+)
+
+var healthCmd = &cobra.Command{
+	Use:   "health",
+	Short: "Check health status of the parity client",
+	Long:  `Check the health status of the parity client and its connected services`,
+	Run:   runHealthCheck,
+}
+
+var (
+	healthDetailed bool
+	healthEndpoint string
+	healthTimeout  time.Duration
+)
+
+func init() {
+	healthCmd.Flags().BoolVar(&healthDetailed, "detailed", false, "Get detailed health information")
+	healthCmd.Flags().StringVar(&healthEndpoint, "endpoint", "http://localhost:3000", "Health check endpoint URL")
+	healthCmd.Flags().DurationVar(&healthTimeout, "timeout", 10*time.Second, "Timeout for health check request")
+}
+
+func runHealthCheck(cmd *cobra.Command, args []string) {
+	logger := gologger.Get().With().Str("component", "health-cmd").Logger()
+
+	var url string
+	if healthDetailed {
+		url = fmt.Sprintf("%s/health/detailed", healthEndpoint)
+	} else {
+		url = fmt.Sprintf("%s/health", healthEndpoint)
+	}
+
+	logger.Info().Str("url", url).Msg("Checking health status")
+
+	client := &http.Client{
+		Timeout: healthTimeout,
+	}
+
+	resp, err := client.Get(url)
+	if err != nil {
+		logger.Error().Err(err).Msg("Failed to connect to health endpoint")
+		fmt.Printf("❌ Health check failed: %v\n", err)
+		return
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode != http.StatusOK {
+		logger.Error().Int("status_code", resp.StatusCode).Msg("Health check returned non-OK status")
+		fmt.Printf("❌ Health check failed with status: %d\n", resp.StatusCode)
+		return
+	}
+
+	var result map[string]interface{}
+	if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {
+		logger.Error().Err(err).Msg("Failed to decode health response")
+		fmt.Printf("❌ Failed to decode health response: %v\n", err)
+		return
+	}
+
+	// Pretty print the JSON response
+	prettyJSON, err := json.MarshalIndent(result, "", "  ")
+	if err != nil {
+		logger.Error().Err(err).Msg("Failed to marshal health response")
+		fmt.Printf("❌ Failed to format health response: %v\n", err)
+		return
+	}
+
+	fmt.Printf("✅ Health check successful\n")
+	fmt.Printf("Status: %s\n", result["status"])
+	fmt.Printf("Timestamp: %s\n", result["timestamp"])
+	fmt.Printf("Version: %s\n", result["version"])
+
+	if healthDetailed {
+		fmt.Printf("\nDetailed Information:\n")
+		fmt.Println(string(prettyJSON))
+	}
+}