bs9 1.4.2 → 1.4.6

package/README.md

@@ -1,7 +1,7 @@
 # BS9 (Bun Sentinel 9) 🚀
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-1.4.2-blue.svg)](https://github.com/xarhang/bs9)
+[![Version](https://img.shields.io/badge/version-1.4.5-blue.svg)](https://github.com/xarhang/bs9)
 [![Security](https://img.shields.io/badge/security-Enterprise-green.svg)](SECURITY.md)
 [![Production Ready](https://img.shields.io/badge/production-Ready-brightgreen.svg)](PRODUCTION.md)
 [![Cross-Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)](https://github.com/bs9/bs9)
@@ -28,7 +28,8 @@ chmod +x ~/.local/bin/bs9
 
 ### 🌐 Platform Support
 - **✅ Auto-Detection**: Automatically detects platform and creates directories
-- **✅ Zero Configuration**: No manual setup required
+- **✅ Zero-Configuration**: No manual setup required
+- **✅ Lightweight**: Minimal dependencies, zero database required for core functionality
 - **✅ Cross-Platform**: Same commands work on all platforms
 
 #### 🐧 Linux
@@ -39,20 +40,20 @@ chmod +x ~/.local/bin/bs9
 #### 🍎 macOS  
 - **Service Manager**: Launchd
 - **Features**: Native macOS integration, automatic recovery
-- **Commands**: All commands + `bs9 macos` for launchd management
+- **Commands**: All commands work automatically on macOS
 
 #### 🪟 Windows
 - **Service Manager**: Windows Services
 - **Features**: PowerShell automation, event log integration
-- **Commands**: All commands + `bs9 windows` for service management
+- **Commands**: All commands work automatically on Windows
 
 ```bash
-# Check your platform
-bs9 platform
+# Check your platform (auto-detected)
+bs9 --help                    # Shows platform info in help
 
-# Platform-specific service management
-bs9 macos create --name my-app --file app.js  # macOS
-bs9 windows create --name my-app --file app.js # Windows
+# Platform-specific service management (auto-detected)
+bs9 start app.js             # Works on Linux, macOS, Windows
+bs9 deploy app.js            # Works on all platforms
 ```
 
 ### 🚀 Killer Feature: Zero-Config Deployment
@@ -182,27 +183,27 @@ bs9 resurrect --all               # Restore all services
 
 ## 🎯 Key Features
 
-### 🚀 Zero-Config Deployment (KILLER FEATURE)
+### ✅ **Zero-Config Deployment**: One-command production setup with `bs9 deploy`
 - **One-Command Setup**: `bs9 deploy app.ts` does everything automatically
 - **Production Ready**: Security hardening, health checks, metrics enabled
 - **Hot Reload**: Update configurations without downtime
 - **Port Detection**: Automatic service discovery and access URLs
 - **Environment Management**: Easy environment variable updates
 
-### 📊 Enhanced Status Display
+### ✅ **Enhanced Status Display**: Visual indicators (✅🔄❌⚠️⏸️) with detailed metrics
 - **Visual Indicators**: ✅🔄❌⚠️⏸️ for instant health assessment
 - **Perfect Alignment**: All columns properly aligned with accurate data
 - **Detailed Metrics**: CPU, Memory, Uptime, Tasks, Port information
 - **Troubleshooting Hints**: Actionable commands for common issues
 - **Service Sections**: Running, Restarting, Failed services clearly separated
 
-### 🔍 Real-time Monitoring
+### 🔍 **Real-time Monitoring**: Live terminal UI with color-coded status
 - **Terminal Dashboard**: Live terminal UI with color-coded status
 - **Web Dashboard**: Browser-based monitoring with auto-refresh
 - **Health Checks**: Automatic `/healthz`, `/readyz`, `/metrics` endpoints
 - **SRE Metrics**: CPU, Memory, Uptime, Task tracking
 
-### 💾 Backup & Recovery System
+### 💾 **Backup & Recovery System**: Complete JSON-based backup system
 - **Service Configuration Backup**: Complete JSON-based backup system
 - **Timestamped Backups**: Version control for service configurations
 - **Bulk Operations**: Save and restore all services at once
@@ -598,11 +599,23 @@ BS9/
 
 ## 🚀 Production Deployment
 
-### System Requirements
-- **OS**: Linux (systemd user mode)
-- **Runtime**: Bun 1.3.6+
-- **Memory**: 512MB minimum per service
-- **Disk**: 1GB for metrics storage
+### System Requirements & Health Check
+```bash
+# Check BS9 installation and system compatibility
+bs9 doctor                    # Basic health check
+bs9 doctor --verbose          # Detailed system information
+bs9 doctor --check platform   # Check platform-specific setup
+bs9 -V                        # Show BS9 version
+
+# System inspection
+bs9 inspect                    # Basic inspection
+bs9 inspect --full              # Complete system inspection
+bs9 inspect --security         # Security inspection only
+bs9 inspect --performance      # Performance inspection only
+bs9 inspect --configuration    # Configuration inspection only
+bs9 inspect --compliance       # Compliance inspection only
+bs9 inspect --report json       # Export inspection report
+```
 
 ### Installation
 #### One-Click Install (Recommended)
@@ -762,9 +775,9 @@ bs9 web --port 8080  # Generates secure session token
 
 ## 📚 Documentation
 
-- **[Production Guide](PRODUCTION.md)** - Production deployment and operations
-- **[Security Policy](SECURITY.md)** - Security features and vulnerability reporting
-- **[Architecture](ARCHITECTURE.md)** - System architecture and design
-- **[Installation Guide](INSTALL.md)** - Detailed installation instructions
-- **[Contributing](CONTRIBUTING.md)** - Development and contribution guidelines
-- **[Changelog](CHANGELOG.md)** - Version history and roadmap
+- **[README.md](README.md)** - Complete getting started guide
+- **[FAQ.md](FAQ.md)** - Frequently asked questions and answers
+- **[COMMANDS.md](docs/COMMANDS.md)** - REST API documentation
+- **[SECURITY.md](SECURITY.md)** - Security policies and reporting
+- **[PRODUCTION.md](PRODUCTION.md)** - Production deployment guide
+- **[CHANGELOG.md](CHANGELOG.md)** - Version history and updates

package/bin/bs9

@@ -31,6 +31,8 @@ import { updateCommand } from "../src/commands/update.js";
 import { dbpoolCommand } from "../src/database/pool.js";
 import { advancedMonitoringCommand } from "../src/monitoring/advanced.js";
 import { consulCommand } from "../src/discovery/consul.js";
+import { doctorCommand } from "../src/commands/doctor.js";
+import { inspectCommand } from "../src/commands/inspect.js";
 
 const program = new Command();
 
@@ -244,4 +246,24 @@ program
   .option("--service <service>", "Service name for discovery")
   .action(consulCommand);
 
+program
+  .command("doctor")
+  .description("Perform comprehensive health check")
+  .option("--check <type>", "Specific check to run (dependencies|configuration|platform)")
+  .option("-v, --verbose", "Verbose output with system information")
+  .action(doctorCommand);
+
+program
+  .command("inspect")
+  .description("Comprehensive system inspection and analysis")
+  .option("--security", "Security inspection only")
+  .option("--performance", "Performance inspection only")
+  .option("--configuration", "Configuration inspection only")
+  .option("--compliance", "Compliance inspection only")
+  .option("--full", "Complete system inspection")
+  .option("--report <format>", "Export report (json|csv)")
+  .option("--deep", "Deep system analysis")
+  .option("-v, --verbose", "Verbose output with detailed analysis")
+  .action(inspectCommand);
+
 program.parse();

package/dist/bs9-nfpea7ta.

@@ -0,0 +1,269 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+import { readFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+
+// Read version from package.json
+const packageJsonPath = join(dirname(import.meta.path), '..', 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+const version = packageJson.version;
+
+import { startCommand } from "../src/commands/start.js";
+import { stopCommand } from "../src/commands/stop.js";
+import { restartCommand } from "../src/commands/restart.js";
+import { statusCommand } from "../src/commands/status.js";
+import { logsCommand } from "../src/commands/logs.js";
+import { monitCommand } from "../src/commands/monit.js";
+import { webCommand } from "../src/commands/web.js";
+import { alertCommand } from "../src/commands/alert.js";
+import { exportCommand } from "../src/commands/export.js";
+import { depsCommand } from "../src/commands/deps.js";
+import { profileCommand } from "../src/commands/profile.js";
+import { deleteCommand } from "../src/commands/delete.js";
+import { saveCommand } from "../src/commands/save.js";
+import { resurrectCommand } from "../src/commands/resurrect.js";
+import { deployCommand } from "../src/commands/deploy.js";
+import { loadbalancerCommand } from "../src/loadbalancer/manager.js";
+import { windowsCommand } from "../src/windows/service.js";
+import { launchdCommand } from "../src/macos/launchd.js";
+import { updateCommand } from "../src/commands/update.js";
+import { dbpoolCommand } from "../src/database/pool.js";
+import { advancedMonitoringCommand } from "../src/monitoring/advanced.js";
+import { consulCommand } from "../src/discovery/consul.js";
+import { doctorCommand } from "../src/commands/doctor.js";
+import { inspectCommand } from "../src/commands/inspect.js";
+
+const program = new Command();
+
+program
+  .name("bs9")
+  .description("BS9 (Bun Sentinel 9) — Mission-critical process manager CLI")
+  .version(version);
+
+program
+  .command("start")
+  .description("Start a process with hardened systemd unit")
+  .argument("<file>", "Application file to start")
+  .option("-n, --name <name>", "Service name")
+  .option("-p, --port <port>", "Port number", "3000")
+  .option("-h, --host <host>", "Host address", "localhost")
+  .option("--https", "Use HTTPS protocol")
+  .option("-e, --env <env>", "Environment variables (can be used multiple times)", (value, previous) => [...(previous || []), value])
+  .option("--otel", "Enable OpenTelemetry instrumentation", true)
+  .option("--prometheus", "Enable Prometheus metrics", true)
+  .option("--build", "Build TypeScript to JavaScript before starting")
+  .action(startCommand);
+
+program
+  .command("stop")
+  .description("Stop a managed service")
+  .argument("<name>", "Service name")
+  .action(stopCommand);
+
+program
+  .command("restart")
+  .description("Restart a managed service")
+  .argument("<name>", "Service name")
+  .action(restartCommand);
+
+program
+  .command("status")
+  .description("Show status and SRE metrics for all services")
+  .option("-w, --watch", "Watch mode (refresh every 2s)")
+  .action(statusCommand);
+
+program
+  .command("logs")
+  .description("Show logs for a service (via journalctl)")
+  .argument("<name>", "Service name")
+  .option("-f, --follow", "Follow logs")
+  .option("-n, --lines <number>", "Number of lines", "50")
+  .action(logsCommand);
+
+program
+  .command("monit")
+  .description("Real-time terminal dashboard for all services")
+  .option("-r, --refresh <seconds>", "Refresh interval in seconds", "2")
+  .action(monitCommand);
+
+program
+  .command("web")
+  .description("Start web-based monitoring dashboard")
+  .option("-p, --port <port>", "Port for web dashboard", "8080")
+  .option("-d, --detach", "Run in background")
+  .action(webCommand);
+
+program
+  .command("alert")
+  .description("Configure alert thresholds and webhooks")
+  .option("--enable", "Enable alerts")
+  .option("--disable", "Disable alerts")
+  .option("--webhook <url>", "Set webhook URL for alerts")
+  .option("--cpu <percentage>", "CPU threshold percentage")
+  .option("--memory <percentage>", "Memory threshold percentage")
+  .option("--errorRate <percentage>", "Error rate threshold percentage")
+  .option("--uptime <percentage>", "Uptime threshold percentage")
+  .option("--cooldown <seconds>", "Alert cooldown period in seconds")
+  .option("--service <name>", "Configure alerts for specific service")
+  .option("--list", "List current alert configuration")
+  .option("--test", "Test webhook connectivity")
+  .action(alertCommand);
+
+program
+  .command("export")
+  .description("Export historical metrics data")
+  .option("-f, --format <format>", "Export format (json|csv)", "json")
+  .option("-h, --hours <hours>", "Hours of data to export", "24")
+  .option("-o, --output <file>", "Output file path")
+  .option("-s, --service <name>", "Export specific service metrics")
+  .action(exportCommand);
+
+program
+  .command("deps")
+  .description("Visualize service dependencies")
+  .option("-f, --format <format>", "Output format (text|dot|json)", "text")
+  .option("-o, --output <file>", "Output file path")
+  .action(depsCommand);
+
+program
+  .command("profile")
+  .description("Performance profiling for services")
+  .option("-d, --duration <seconds>", "Profiling duration", "60")
+  .option("-i, --interval <ms>", "Sampling interval", "1000")
+  .option("-s, --service <name>", "Service name to profile")
+  .option("--flamegraph", "Generate flame graph")
+  .option("--top <number>", "Show top N functions", "10")
+  .action(profileCommand);
+
+program
+  .command("delete")
+  .description("Delete managed services")
+  .argument("[name]", "Service name (optional)")
+  .option("-a, --all", "Delete all services")
+  .option("-f, --force", "Force deletion without errors")
+  .option("-r, --remove", "Remove service configuration files")
+  .option("-t, --timeout <seconds>", "Timeout for graceful shutdown (default: 30)")
+  .action(deleteCommand);
+
+program
+  .command("save")
+  .description("Save service configurations to backup")
+  .argument("[name]", "Service name (optional)")
+  .option("-a, --all", "Save all services")
+  .option("-f, --force", "Force save without errors")
+  .option("-b, --backup", "Create timestamped backup")
+  .action(saveCommand);
+
+program
+  .command("resurrect")
+  .description("Resurrect services from backup")
+  .argument("[name]", "Service name (optional)")
+  .option("-a, --all", "Resurrect all services")
+  .option("-f, --force", "Force resurrection without errors")
+  .option("-c, --config <file>", "Configuration file to use")
+  .action(resurrectCommand);
+
+program
+  .command("deploy")
+  .description("🚀 Deploy applications with zero-config production setup")
+  .argument("<file>", "Application file to deploy")
+  .option("-n, --name <name>", "Service name")
+  .option("-p, --port <port>", "Port number", "3000")
+  .option("-h, --host <host>", "Host address", "localhost")
+  .option("-e, --env <env>", "Environment variables (multiple)", (value, previous) => [...(previous || []), value])
+  .option("-i, --instances <number>", "Number of instances")
+  .option("--memory <memory>", "Memory limit")
+  .option("--cpu <cpu>", "CPU limit")
+  .option("--log-level <level>", "Log level")
+  .option("--log-file <file>", "Log file path")
+  .option("--restart <policy>", "Restart policy")
+  .option("--no-health", "Skip health check")
+  .option("--no-metrics", "Disable metrics")
+  .option("--no-otel", "Disable OpenTelemetry")
+  .option("--no-prometheus", "Disable Prometheus")
+  .option("--https", "Enable HTTPS")
+  .option("--no-linger", "Don't enable linger")
+  .option("-f, --force", "Force deployment")
+  .option("--reload", "Reload existing service")
+  .option("--build", "Build TypeScript")
+  .action(deployCommand);
+
+program
+  .command("loadbalancer")
+  .description("Load balancer management")
+  .argument("<action>", "Action to perform")
+  .option("-p, --port <port>", "Load balancer port", "8080")
+  .option("-a, --algorithm <type>", "Load balancing algorithm", "round-robin")
+  .option("-b, --backends <list>", "Backend servers (host:port,host:port)")
+  .option("--health-check", "Enable health checking", true)
+  .option("--health-path <path>", "Health check path", "/healthz")
+  .option("--health-interval <ms>", "Health check interval", "10000")
+  .action(loadbalancerCommand);
+
+program
+  .command("dbpool")
+  .description("Database connection pool management")
+  .argument("<action>", "Action to perform")
+  .option("--host <host>", "Database host", "localhost")
+  .option("--port <port>", "Database port", "5432")
+  .option("--database <name>", "Database name", "testdb")
+  .option("--username <user>", "Database username", "user")
+  .option("--password <pass>", "Database password", "password")
+  .option("--max-connections <num>", "Maximum connections", "10")
+  .option("--min-connections <num>", "Minimum connections", "2")
+  .option("--concurrency <num>", "Test concurrency", "10")
+  .option("--iterations <num>", "Test iterations", "100")
+  .action(dbpoolCommand);
+
+program
+  .command("update")
+  .description("Update BS9 to latest version")
+  .option("--check", "Check for updates without installing")
+  .option("--force", "Force update even if already latest")
+  .option("--rollback", "Rollback to previous version")
+  .option("--version <version>", "Update to specific version")
+  .action(updateCommand);
+
+program
+  .command("advanced")
+  .description("Advanced monitoring dashboard")
+  .option("--port <port>", "Dashboard port", "8090")
+  .action(advancedMonitoringCommand);
+
+program
+  .command("consul")
+  .description("Consul service discovery")
+  .argument("<action>", "Action to perform")
+  .option("--consul-url <url>", "Consul URL", "http://localhost:8500")
+  .option("--name <name>", "Service name")
+  .option("--id <id>", "Service ID")
+  .option("--address <address>", "Service address")
+  .option("--port <port>", "Service port")
+  .option("--tags <tags>", "Service tags (comma-separated)")
+  .option("--health-check <url>", "Health check URL")
+  .option("--meta <json>", "Service metadata (JSON)")
+  .option("--service <service>", "Service name for discovery")
+  .action(consulCommand);
+
+program
+  .command("doctor")
+  .description("Perform comprehensive health check")
+  .option("--check <type>", "Specific check to run (dependencies|configuration|platform)")
+  .option("-v, --verbose", "Verbose output with system information")
+  .action(doctorCommand);
+
+program
+  .command("inspect")
+  .description("Comprehensive system inspection and analysis")
+  .option("--security", "Security inspection only")
+  .option("--performance", "Performance inspection only")
+  .option("--configuration", "Configuration inspection only")
+  .option("--compliance", "Compliance inspection only")
+  .option("--full", "Complete system inspection")
+  .option("--report <format>", "Export report (json|csv)")
+  .option("--deep", "Deep system analysis")
+  .option("-v, --verbose", "Verbose output with detailed analysis")
+  .action(inspectCommand);
+
+program.parse();