refactor: rename 'node-pulse' to 'nodepulse' across configuration, documentation, and codebase

Author: guiyumin

.gitignore

@@ -1,4 +1,6 @@
 # Binaries
+nodepulse
+/nodepulse-*
 pulse
 /pulse-*
 /build/pulse-*
@@ -24,9 +26,11 @@ build/
 
 # Buffer directory (for local testing)
 buffer/
+/var/lib/nodepulse/
 /var/lib/node-pulse/
 
 # Config files (keep template only)
+/etc/nodepulse/
 /etc/node-pulse/
 
 # IDE

cmd/service.go

@@ -12,9 +12,9 @@ import (
 )
 
 const (
-	serviceName     = "node-pulse"
-	serviceFile     = "/etc/systemd/system/node-pulse.service"
-	binaryPath      = "/usr/local/bin/pulse"
+	serviceName     = "nodepulse"
+	serviceFile     = "/etc/systemd/system/nodepulse.service"
+	binaryPath      = "/opt/nodepulse/nodepulse"
 	serviceTemplate = `[Unit]
 Description=NodePulse Server Monitor Agent
 After=network.target
@@ -100,7 +100,7 @@ func installService(cmd *cobra.Command, args []string) error {
 		return fmt.Errorf("failed to get executable path: %w", err)
 	}
 
-	// Copy binary to /usr/local/bin/pulse if not already there
+	// Copy binary to installation directory if not already there
 	if exePath != binaryPath {
 		if err := copyFile(exePath, binaryPath); err != nil {
 			return fmt.Errorf("failed to copy binary: %w", err)
@@ -130,7 +130,7 @@ func installService(cmd *cobra.Command, args []string) error {
 
 	fmt.Println("Service installed and enabled successfully!")
 	fmt.Println("\nTo start the service, run:")
-	fmt.Printf("  sudo pulse service start\n")
+	fmt.Printf("  sudo nodepulse service start\n")
 	return nil
 }
 

cmd/start.go

@@ -178,8 +178,8 @@ func runInBackground() error {
 	// Print warning
 	fmt.Println("WARNING: Running in daemon mode (-d) is for development and debugging only.")
 	fmt.Println("For production use, install as a systemd service:")
-	fmt.Println("  pulse service install")
-	fmt.Println("  pulse service start")
+	fmt.Println("  nodepulse service install")
+	fmt.Println("  nodepulse service start")
 	fmt.Println()
 
 	// Build command arguments without the daemon flag

cmd/status.go

@@ -83,15 +83,15 @@ func runStatus(cmd *cobra.Command, args []string) error {
 // getServiceStatus checks if the systemd service is running
 func getServiceStatus() string {
 	// Try to check systemd status
-	cmd := exec.Command("systemctl", "is-active", "node-pulse")
+	cmd := exec.Command("systemctl", "is-active", "nodepulse")
 	output, err := cmd.Output()
 
 	if err == nil && string(output) == "active\n" {
 		return "running (via systemd)"
 	}
 
 	// Check if service exists but is not active
-	cmd = exec.Command("systemctl", "is-enabled", "node-pulse")
+	cmd = exec.Command("systemctl", "is-enabled", "nodepulse")
 	_, err = cmd.Output()
 
 	if err == nil {
@@ -101,9 +101,9 @@ func getServiceStatus() string {
 	return "not installed as systemd service"
 }
 
-// countBufferFiles counts the number of .jsonl files in the buffer directory
+// countBufferFiles counts the number of .prom files in the buffer directory
 func countBufferFiles(bufferPath string) (int, error) {
-	pattern := filepath.Join(bufferPath, "*.jsonl")
+	pattern := filepath.Join(bufferPath, "*.prom")
 	files, err := filepath.Glob(pattern)
 	if err != nil {
 		return 0, err

cmd/stop.go

@@ -36,7 +36,7 @@ func stopAgent(cmd *cobra.Command, args []string) error {
 			fmt.Println("No daemon agent is running.")
 			fmt.Println("However, the systemd service appears to be active.")
 			fmt.Println("To stop the systemd service, use:")
-			fmt.Println("  sudo pulse service stop")
+			fmt.Println("  sudo nodepulse service stop")
 			return nil
 		}
 		fmt.Println("No agent is running")
@@ -87,8 +87,8 @@ func stopAgent(cmd *cobra.Command, args []string) error {
 	return nil
 }
 
-// isSystemdServiceActive checks if the node-pulse systemd service is active
+// isSystemdServiceActive checks if the nodepulse systemd service is active
 func isSystemdServiceActive() bool {
-	cmd := exec.Command("systemctl", "is-active", "--quiet", "node-pulse")
+	cmd := exec.Command("systemctl", "is-active", "--quiet", "nodepulse")
 	return cmd.Run() == nil
 }

docs/buffer-mechanism.md

@@ -142,9 +142,9 @@ YYYYMMDD-HHMMSS-<server_id>.prom
 
 **Examples:**
 ```
-/var/lib/node-pulse/buffer/20251027-140000-550e8400-e29b-41d4-a716-446655440000.prom
-/var/lib/node-pulse/buffer/20251027-140015-550e8400-e29b-41d4-a716-446655440000.prom
-/var/lib/node-pulse/buffer/20251027-140030-550e8400-e29b-41d4-a716-446655440000.prom
+/var/lib/nodepulse/buffer/20251027-140000-550e8400-e29b-41d4-a716-446655440000.prom
+/var/lib/nodepulse/buffer/20251027-140015-550e8400-e29b-41d4-a716-446655440000.prom
+/var/lib/nodepulse/buffer/20251027-140030-550e8400-e29b-41d4-a716-446655440000.prom
 ```
 
 **Content:**
@@ -165,13 +165,13 @@ node_memory_MemTotal_bytes 8.589934592e+09
 
 ```yaml
 buffer:
-  path: "/var/lib/node-pulse/buffer"
+  path: "/var/lib/nodepulse/buffer"
   retention_hours: 48
   batch_size: 5
 ```
 
 **Settings:**
-- `path`: Buffer directory location (default: `/var/lib/node-pulse/buffer`)
+- `path`: Buffer directory location (default: `/var/lib/nodepulse/buffer`)
 - `retention_hours`: Auto-delete files older than this (default: 48 hours)
 - `batch_size`: Maximum files to process per batch (default: 5)
 
@@ -278,17 +278,17 @@ Node Pulse Agent Status
 =====================
 
 Server ID:     550e8400-e29b-41d4-a716-446655440000
-Config File:   /etc/node-pulse/nodepulse.yml
+Config File:   /etc/nodepulse/nodepulse.yml
 Endpoint:      https://dashboard.nodepulse.io/metrics/prometheus
 Interval:      15s
 
 Agent:         running (via systemd)
 
-Buffer:        12 report(s) pending in /var/lib/node-pulse/buffer
+Buffer:        12 report(s) pending in /var/lib/nodepulse/buffer
                Oldest: 2025-10-27 14:00:00
                Total size: 156 KB
 
-Log File:      /var/log/node-pulse/agent.log
+Log File:      /var/log/nodepulse/agent.log
 ```
 
 **Buffer metrics:**
@@ -328,7 +328,7 @@ Log File:      /var/log/node-pulse/agent.log
 **Default settings (recommended for most deployments):**
 ```yaml
 buffer:
-  path: "/var/lib/node-pulse/buffer"
+  path: "/var/lib/nodepulse/buffer"
   retention_hours: 48
   batch_size: 5
 ```

docs/project-overview.md

@@ -3,10 +3,11 @@
 ## Project Information
 
 - **Repository**: `github.com/node-pulse/agent`
-- **CLI Command**: `pulse`
+- **CLI Command**: `nodepulse`
 - **Language**: Go
 - **Framework**: Cobra (CLI)
 - **Target**: Linux servers (arm64 + amd64)
+- **Deployment**: Ansible-based (centrally managed from dashboard)
 
 ## Purpose
 
@@ -24,8 +25,7 @@ agent/
 │   ├── stop.go           # Stop command (stops daemon mode only)
 │   ├── setup.go          # Setup wizard (quick mode only)
 │   ├── status.go         # Status command (shows server ID, config, service, buffer)
-│   ├── service.go        # Service management (systemd)
-│   └── update.go         # Self-updater
+│   └── service.go        # Service management (systemd)
 ├── internal/
 │   ├── prometheus/       # Prometheus scraper
 │   │   ├── scraper.go    # HTTP scraper for node_exporter
@@ -39,8 +39,7 @@ agent/
 │   │   └── serverid.go   # Server ID persistence
 │   ├── logger/           # Structured logging (zap)
 │   ├── pidfile/          # PID file management
-│   ├── installer/        # Setup installer logic
-│   └── updater/          # Self-update system
+│   └── installer/        # Setup installer logic
 ├── docs/                 # Documentation
 ├── .goreleaser.yaml      # Cross-compilation config
 ├── nodepulse.yml         # Example config file
@@ -86,27 +85,27 @@ Each agent instance requires a unique `server_id` to identify which server is re
 
 **Source:**
 - Assigned by dashboard when adding server
-- Passed to agent via Ansible deployment or `pulse setup --yes`
+- Passed to agent via Ansible deployment or `nodepulse setup --yes`
 
 **Persistence locations** (tried in order):
 
-- `/var/lib/node-pulse/server_id` ✅ (survives re-setup, not OS reinstall)
-- `/etc/node-pulse/server_id`
-- `~/.node-pulse/server_id`
+- `/var/lib/nodepulse/server_id` ✅ (survives re-setup, not OS reinstall)
+- `/etc/nodepulse/server_id`
+- `~/.nodepulse/server_id`
 - `./server_id` (fallback)
 
 **Stability:**
 
-- UUID persists across agent updates
+- UUID persists across agent updates (Ansible manages updates)
 - UUID is regenerated only after OS reinstall (when persistent file is wiped)
-- Check current UUID: `pulse status`
+- Check current UUID: `nodepulse status`
 
 ### Buffer Strategy (Write-Ahead Log Pattern)
 
 **Always save to buffer first, then drain in background:**
 
 ```
-/var/lib/node-pulse/buffer/
+/var/lib/nodepulse/buffer/
 ├── 20251027-140000-550e8400-e29b-41d4-a716-446655440000.prom
 ├── 20251027-140015-550e8400-e29b-41d4-a716-446655440000.prom
 └── 20251027-140030-550e8400-e29b-41d4-a716-446655440000.prom
@@ -125,7 +124,7 @@ Each agent instance requires a unique `server_id` to identify which server is re
 
 ## Configuration File
 
-**Location**: `/etc/node-pulse/nodepulse.yml`
+**Location**: `/etc/nodepulse/nodepulse.yml`
 
 ```yaml
 server:
@@ -142,15 +141,15 @@ prometheus:
   timeout: 3s
 
 buffer:
-  path: "/var/lib/node-pulse/buffer"
+  path: "/var/lib/nodepulse/buffer"
   retention_hours: 48
   batch_size: 5
 
 logging:
   level: "info"
   output: "stdout"
   file:
-    path: "/var/log/node-pulse/agent.log"
+    path: "/var/log/nodepulse/agent.log"
     max_size_mb: 10
     max_backups: 3
     max_age_days: 7
@@ -170,45 +169,45 @@ All other settings use hardcoded defaults.
 ### Core Commands
 
 ```bash
-pulse setup --yes            # Quick setup (prompts for endpoint and server_id)
-pulse start                  # Run agent in foreground (for testing/development)
-pulse start -d               # Run agent in background daemon mode (development only)
-pulse stop                   # Stop daemon mode agent (does not affect systemd service)
-pulse status                 # Display comprehensive status
+nodepulse setup --yes            # Quick setup (prompts for endpoint and server_id)
+nodepulse start                  # Run agent in foreground (for testing/development)
+nodepulse start -d               # Run agent in background daemon mode (development only)
+nodepulse stop                   # Stop daemon mode agent (does not affect systemd service)
+nodepulse status                 # Display comprehensive status
 ```
 
 ### Running Modes
 
-**1. Foreground Mode** (`pulse start`)
+**1. Foreground Mode** (`nodepulse start`)
 - Blocks terminal, runs in foreground
 - Creates PID file to prevent duplicate runs
 - Stop with: Ctrl+C (graceful shutdown with cleanup)
 - Best for: Development and testing
 
-**2. Daemon Mode** (`pulse start -d`)
+**2. Daemon Mode** (`nodepulse start -d`)
 - Runs in background, detached from terminal
 - Creates PID file for process management
-- Stop with: `pulse stop` command
+- Stop with: `nodepulse stop` command
 - Sends SIGTERM (5s grace period) then SIGKILL if needed
 - Best for: Quick testing, not production
 
-**3. Systemd Service** (`pulse service start`)
+**3. Systemd Service** (`nodepulse service start`)
 - Managed by systemd (no PID file)
 - Auto-restart on failure, boot on startup
-- Stop with: `pulse service stop`
-- Best for: Production deployments
+- Stop with: `nodepulse service stop`
+- Best for: Production deployments (managed by Ansible)
 
-**Important**: `pulse stop` only works for daemon mode. If systemd service is running, it provides helpful guidance to use `pulse service stop` instead.
+**Important**: `nodepulse stop` only works for daemon mode. If systemd service is running, it provides helpful guidance to use `nodepulse service stop` instead.
 
 ### Service Management
 
 ```bash
-pulse service install        # Install systemd service
-pulse service start          # Start the service
-pulse service stop           # Stop the service
-pulse service restart        # Restart the service
-pulse service status         # Check detailed systemd service status
-pulse service uninstall      # Remove the service
+nodepulse service install        # Install systemd service
+nodepulse service start          # Start the service
+nodepulse service stop           # Stop the service
+nodepulse service restart        # Restart the service
+nodepulse service status         # Check detailed systemd service status
+nodepulse service uninstall      # Remove the service
 ```
 
 ## Build & Release
@@ -277,5 +276,13 @@ node_memory_MemTotal_bytes 8.589934592e+09
 - ✅ Background drain loop with jitter
 - ✅ Batch processing
 - ✅ Service management
-- ✅ Self-update system
+- ✅ Ansible-based deployment and updates
 - ✅ Documentation complete
+
+### Update Management
+
+Agent updates are **centrally managed via Ansible** from the dashboard:
+- No self-update mechanism in agent
+- Version control with rollback capability
+- Staged rollouts across server fleet
+- Deployment tracking per server

docs/pulse-logging-prd.md

@@ -65,7 +65,7 @@ logging:
   level: "info" # debug, info, warn, error
   output: "both" # stdout, file, both
   file:
-    path: "/var/log/node-pulse/agent.log"
+    path: "/var/log/nodepulse/agent.log"
     max_size_mb: 10
     max_backups: 3
     max_age_days: 7
@@ -286,7 +286,7 @@ logging:
   level: "info"
   output: "both"
   file:
-    path: "/var/log/node-pulse/agent.log"
+    path: "/var/log/nodepulse/agent.log"
     max_size_mb: 10
     max_backups: 5
     max_age_days: 7

internal/report/sender.go

@@ -91,7 +91,7 @@ func (s *Sender) sendPrometheusHTTP(data []byte, serverID string) error {
 	}
 
 	req.Header.Set("Content-Type", "text/plain; version=0.0.4")
-	req.Header.Set("User-Agent", "node-pulse-agent/2.0")
+	req.Header.Set("User-Agent", "nodepulse-agent/2.0")
 
 	resp, err := s.client.Do(req)
 	if err != nil {