bs9 1.4.3 → 1.5.0

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.3-blue.svg)](https://github.com/xarhang/bs9)
+[![Version](https://img.shields.io/badge/version-1.5.0-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)
@@ -40,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
@@ -91,6 +91,22 @@ bs9 start app.js --host 0.0.0.0 --port 8080        # Custom host and port
 bs9 start app.js --host 192.168.1.100 --https      # Custom host with HTTPS
 bs9 start app.ts --build --name myapp --port 8080 --env NODE_ENV=production --host 0.0.0.0 --https
 
+# 🆕 Multi-Service Management (NEW!)
+bs9 start [app1, app2, app3]                       # Start multiple services
+bs9 start [app-*]                                   # Start services matching pattern
+bs9 start all                                      # Start all services
+bs9 stop [app1, app2]                              # Stop multiple services
+bs9 stop [web-*]                                   # Stop services matching pattern
+bs9 stop all                                       # Stop all services (with confirmation)
+bs9 restart [app1, app2, app3]                     # Restart multiple services
+bs9 restart [*-prod]                               # Restart services matching pattern
+bs9 restart all                                    # Restart all services (with confirmation)
+bs9 delete [test-*]                                # Delete services matching pattern
+bs9 delete all                                     # Delete all services (with confirmation)
+bs9 status [app1, app2, app3]                      # Status of multiple services
+bs9 status [web-*]                                 # Status of services matching pattern
+bs9 status all                                     # Status of all services
+
 # Stop service
 bs9 stop myapp
 
@@ -599,11 +615,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)

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();
 
@@ -41,8 +43,8 @@ program
 
 program
   .command("start")
-  .description("Start a process with hardened systemd unit")
-  .argument("<file>", "Application file to start")
+  .description("Start one or more services")
+  .argument("[file...]", "Application file, service name, array [app1,app2], pattern [app-*], or [all]")
   .option("-n, --name <name>", "Service name")
   .option("-p, --port <port>", "Port number", "3000")
   .option("-h, --host <host>", "Host address", "localhost")
@@ -55,19 +57,20 @@ program
 
 program
   .command("stop")
-  .description("Stop a managed service")
-  .argument("<name>", "Service name")
+  .description("Stop one or more services")
+  .argument("[name...]", "Service name, array [app1,app2], pattern [app-*], or [all]")
   .action(stopCommand);
 
 program
   .command("restart")
-  .description("Restart a managed service")
-  .argument("<name>", "Service name")
+  .description("Restart one or more services")
+  .argument("[name...]", "Service name, array [app1,app2], pattern [app-*], or [all]")
   .action(restartCommand);
 
 program
   .command("status")
-  .description("Show status and SRE metrics for all services")
+  .description("Show status and SRE metrics for services")
+  .argument("[name...]", "Service name, array [app1,app2], pattern [app-*], or [all]")
   .option("-w, --watch", "Watch mode (refresh every 2s)")
   .action(statusCommand);
 
@@ -136,10 +139,10 @@ program
 
 program
   .command("delete")
-  .description("Delete managed services")
-  .argument("[name]", "Service name (optional)")
+  .description("Delete one or more managed services")
+  .argument("[name...]", "Service name, array [app1,app2], pattern [test-*], or [all]")
   .option("-a, --all", "Delete all services")
-  .option("-f, --force", "Force deletion without errors")
+  .option("-f, --force", "Force deletion without confirmation")
   .option("-r, --remove", "Remove service configuration files")
   .option("-t, --timeout <seconds>", "Timeout for graceful shutdown (default: 30)")
   .action(deleteCommand);
@@ -244,4 +247,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-cbcmk6jy.

@@ -0,0 +1,389 @@
+#!/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";
+import { startAllServices, stopAllServices, restartAllServices, deleteAllServices, listServices } from "../src/commands/services.js";
+import { createAlert, listAlerts, toggleAlert, deleteAlert, testAlert, monitorAlerts, setGlobalConfig } from "../src/commands/custom-alerts.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
+  .command("services")
+  .description("Multi-service management commands")
+  .option("--all", "Apply to all services")
+  .option("--pattern <pattern>", "Filter services by name pattern")
+  .option("--pid <pid>", "Filter services by PID")
+  .option("--status <status>", "Filter services by status")
+  .option("--force", "Skip confirmation prompts")
+  .action(listServices);
+
+program
+  .command("start-all")
+  .description("Start all stopped services")
+  .option("--all", "Start all services")
+  .option("--pattern <pattern>", "Start services matching pattern")
+  .option("--status <status>", "Start services with specific status")
+  .action(startAllServices);
+
+program
+  .command("stop-all")
+  .description("Stop all running services")
+  .option("--all", "Stop all services")
+  .option("--pattern <pattern>", "Stop services matching pattern")
+  .option("--pid <pid>", "Stop service by PID")
+  .action(stopAllServices);
+
+program
+  .command("restart-all")
+  .description("Restart multiple services")
+  .option("--all", "Restart all services")
+  .option("--pattern <pattern>", "Restart services matching pattern")
+  .option("--status <status>", "Restart services with specific status")
+  .action(restartAllServices);
+
+program
+  .command("delete-all")
+  .description("Delete multiple services")
+  .option("--all", "Delete all services")
+  .option("--pattern <pattern>", "Delete services matching pattern")
+  .option("--force", "Skip confirmation prompts")
+  .action(deleteAllServices);
+
+program
+  .command("alert-create")
+  .description("Create a custom alert")
+  .option("--name <name>", "Alert name")
+  .option("--service <service>", "Service name (optional)")
+  .option("--metric <metric>", "Metric to monitor")
+  .option("--threshold <threshold>", "Alert threshold")
+  .option("--operator <operator>", "Comparison operator (>, <, =, >=, <=)")
+  .option("--webhook <webhook>", "Webhook URL")
+  .option("--email <email>", "Email address")
+  .option("--cooldown <cooldown>", "Cooldown period in seconds")
+  .option("--severity <severity>", "Alert severity (low, medium, high, critical)")
+  .option("--description <description>", "Alert description")
+  .action((options) => {
+    if (!options.name || !options.metric || !options.threshold || !options.operator || !options.severity || !options.description) {
+      console.error("❌ Required options: --name, --metric, --threshold, --operator, --severity, --description");
+      return;
+    }
+    createAlert({
+      name: options.name,
+      service: options.service,
+      metric: options.metric,
+      threshold: parseFloat(options.threshold),
+      operator: options.operator,
+      webhook: options.webhook,
+      email: options.email,
+      cooldown: options.cooldown ? parseInt(options.cooldown) : undefined,
+      severity: options.severity,
+      description: options.description
+    });
+  });
+
+program
+  .command("alert-list")
+  .description("List custom alerts")
+  .option("--service <service>", "Filter by service")
+  .option("--enabled", "Show only enabled alerts")
+  .action(listAlerts);
+
+program
+  .command("alert-enable")
+  .description("Enable a custom alert")
+  .argument("<alert-id>", "Alert ID")
+  .action((alertId) => toggleAlert(alertId, true));
+
+program
+  .command("alert-disable")
+  .description("Disable a custom alert")
+  .argument("<alert-id>", "Alert ID")
+  .action((alertId) => toggleAlert(alertId, false));
+
+program
+  .command("alert-delete")
+  .description("Delete a custom alert")
+  .argument("<alert-id>", "Alert ID")
+  .action(deleteAlert);
+
+program
+  .command("alert-test")
+  .description("Test a custom alert")
+  .argument("<alert-id>", "Alert ID")
+  .action(testAlert);
+
+program
+  .command("alert-monitor")
+  .description("Monitor and trigger alerts")
+  .action(monitorAlerts);
+
+program
+  .command("alert-config")
+  .description("Set global alert configuration")
+  .option("--webhook <webhook>", "Global webhook URL")
+  .option("--email <email>", "Global email address")
+  .option("--cooldown <cooldown>", "Default cooldown in seconds")
+  .action(setGlobalConfig);
+
+program.parse();