bs9 1.0.0 → 1.1.0

package/dist/bs9-nv7nseny.

@@ -0,0 +1,197 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+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 { loadbalancerCommand } from "../src/loadbalancer/manager.js";
+import { windowsCommand } from "../src/windows/service.js";
+import { launchdCommand } from "../src/macos/launchd.js";
+import { dbpoolCommand } from "../src/database/pool.js";
+
+const program = new Command();
+
+program
+  .name("bs9")
+  .description("BS9 (Bun Sentinel 9) — Mission-critical process manager CLI")
+  .version("1.0.0");
+
+program
+  .command("start")
+  .description("Start a process with hardened systemd unit")
+  .argument("<file>", "Script or executable to run")
+  .option("-n, --name <name>", "Service name (defaults to filename)")
+  .option("-p, --port <port>", "Port to expose (for metrics/health)", "3000")
+  .option("--env <env...>", "Environment variables (KEY=VALUE)")
+  .option("--no-otel", "Disable automatic OpenTelemetry injection")
+  .option("--no-prometheus", "Disable automatic Prometheus metrics")
+  .option("--build", "Build TypeScript to optimized JavaScript for production (AOT)")
+  .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("-o, --output <file>", "Output file path")
+  .action(profileCommand);
+
+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);
+
+// Platform-specific commands
+const platform = process.platform;
+
+if (platform === 'win32') {
+  program
+    .command("windows")
+    .description("Windows service management")
+    .argument("<action>", "Action to perform")
+    .option("--name <name>", "Service name")
+    .option("--file <path>", "Executable file path")
+    .option("--displayName <name>", "Display name")
+    .option("--description <desc>", "Service description")
+    .option("--workingDir <path>", "Working directory")
+    .option("--args <args>", "Command line arguments (JSON array)")
+    .option("--env <env>", "Environment variables (JSON object)")
+    .action(windowsCommand);
+} else if (platform === 'darwin') {
+  program
+    .command("macos")
+    .description("macOS launchd service management")
+    .argument("<action>", "Action to perform")
+    .option("--name <name>", "Service name")
+    .option("--file <path>", "Executable file path")
+    .option("--workingDir <path>", "Working directory")
+    .option("--args <args>", "Command line arguments (JSON array)")
+    .option("--env <env>", "Environment variables (JSON object)")
+    .option("--autoStart", "Start service at load")
+    .option("--keepAlive", "Keep service alive")
+    .option("--logOut <path>", "Standard output log path")
+    .option("--logErr <path>", "Standard error log path")
+    .action(launchdCommand);
+}
+
+// Add platform info command
+program
+  .command("platform")
+  .description("Show platform information")
+  .action(() => {
+    const { getPlatformInfo, getPlatformHelp } = require("../src/platform/detect.js");
+    const info = getPlatformInfo();
+    console.log('🖥️  BS9 Platform Information');
+    console.log('='.repeat(50));
+    console.log(`Platform: ${info.platform}`);
+    console.log(`Service Manager: ${info.serviceManager}`);
+    console.log(`Config Directory: ${info.configDir}`);
+    console.log(`Log Directory: ${info.logDir}`);
+    console.log(`Service Directory: ${info.serviceDir}`);
+    console.log('');
+    console.log(getPlatformHelp());
+  });
+
+program.parse();

package/dist/bs9-r6b9zpw0.

@@ -0,0 +1,156 @@
+#!/usr/bin/env bun
+
+import { Command } from "commander";
+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 { windowsCommand } from "../src/windows/service.js";
+import { loadbalancerCommand } from "../src/loadbalancer/manager.js";
+import { dbpoolCommand } from "../src/database/pool.js";
+
+const program = new Command();
+
+program
+  .name("bs9")
+  .description("BS9 (Bun Sentinel 9) — Mission-critical process manager CLI")
+  .version("1.0.0");
+
+program
+  .command("start")
+  .description("Start a process with hardened systemd unit")
+  .argument("<file>", "Script or executable to run")
+  .option("-n, --name <name>", "Service name (defaults to filename)")
+  .option("-p, --port <port>", "Port to expose (for metrics/health)", "3000")
+  .option("--env <env...>", "Environment variables (KEY=VALUE)")
+  .option("--no-otel", "Disable automatic OpenTelemetry injection")
+  .option("--no-prometheus", "Disable automatic Prometheus metrics")
+  .option("--build", "Build TypeScript to optimized JavaScript for production (AOT)")
+  .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("-o, --output <file>", "Output file path")
+  .action(profileCommand);
+
+program
+  .command("windows")
+  .description("Windows service management")
+  .argument("<action>", "Action to perform", "create|start|stop|delete|status")
+  .argument("[name]", "Service name")
+  .option("--file <path>", "Service file path")
+  .option("--start-type <type>", "Start type (auto|demand|disabled)", "auto")
+  .option("--auto-start", "Auto-start service", true)
+  .option("--env <key=value>", "Environment variables")
+  .action(windowsCommand);
+
+program
+  .command("loadbalancer")
+  .description("Load balancer management")
+  .argument("<action>", "Action to perform", "start|status|config")
+  .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", "start|test|stats")
+  .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.parse();

package/dist/bs9.js

@@ -0,0 +1,2 @@
+// @bun
+var e="./bs9-064xs9r9.";export{e as default};

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "bs9",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Bun Sentinel 9 - High-performance, non-root process manager for Bun",
   "type": "module",
   "main": "src/index.ts",
   "bin": {
-    "bs9": "./bin/bs9",
-    "bsn": "./bin/bs9"
+    "bs9": "./bin/bs9"
   },
   "files": [
     "bin",
@@ -36,7 +35,7 @@
     "@opentelemetry/resources": "^1.23.0",
     "@opentelemetry/sdk-node": "^0.50.0",
     "@opentelemetry/semantic-conventions": "^1.23.0",
-    "commander": "^12.0.0",
+    "commander": "^14.0.2",
     "pg": "^8.12.0",
     "pino": "^9.3.1",
     "prom-client": "^15.1.2"

package/src/commands/deps.ts

@@ -0,0 +1,295 @@
+#!/usr/bin/env bun
+
+import { execSync } from "node:child_process";
+import { setTimeout } from "node:timers/promises";
+
+interface DepOptions {
+  format?: string;
+  output?: string;
+}
+
+interface ServiceDependency {
+  name: string;
+  dependsOn: string[];
+  status: 'running' | 'stopped' | 'failed' | 'unknown';
+  health: 'healthy' | 'unhealthy' | 'unknown';
+  port?: number;
+  endpoints: string[];
+}
+
+interface DependencyGraph {
+  services: ServiceDependency[];
+  edges: Array<{
+    from: string;
+    to: string;
+    type: 'http' | 'database' | 'message' | 'custom';
+  }>;
+}
+
+export async function depsCommand(options: DepOptions): Promise<void> {
+  console.log('🔗 BS9 Service Dependency Visualization');
+  console.log('='.repeat(80));
+  
+  try {
+    const graph = await buildDependencyGraph();
+    
+    if (options.format === 'dot') {
+      const dotOutput = generateDotGraph(graph);
+      if (options.output) {
+        await Bun.write(options.output, dotOutput);
+        console.log(`✅ Dependency graph saved to: ${options.output}`);
+      } else {
+        console.log(dotOutput);
+      }
+    } else if (options.format === 'json') {
+      const jsonOutput = JSON.stringify(graph, null, 2);
+      if (options.output) {
+        await Bun.write(options.output, jsonOutput);
+        console.log(`✅ Dependency graph saved to: ${options.output}`);
+      } else {
+        console.log(jsonOutput);
+      }
+    } else {
+      displayDependencyGraph(graph);
+    }
+    
+  } catch (error) {
+    console.error(`❌ Failed to analyze dependencies: ${error}`);
+    process.exit(1);
+  }
+}
+
+async function buildDependencyGraph(): Promise<DependencyGraph> {
+  const services: ServiceDependency[] = [];
+  const edges: Array<{from: string; to: string; type: 'http' | 'database' | 'message' | 'custom'}> = [];
+  
+  try {
+    // Get all BS9 services
+    const listOutput = execSync("systemctl --user list-units --type=service --no-pager --no-legend", { encoding: "utf-8" });
+    const lines = listOutput.split("\n").filter(line => line.includes(".service"));
+    
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      
+      const match = line.match(/^(?:\s*([●\s○]))?\s*([^\s]+)\.service\s+([^\s]+)\s+([^\s]+)\s+([^\s]+)\s+(.+)$/);
+      if (!match) continue;
+      
+      const [, statusIndicator, name, loaded, active, sub, description] = match;
+      
+      if (!description.includes("Bun Service:") && !description.includes("BS9 Service:")) continue;
+      
+      const service: ServiceDependency = {
+        name,
+        dependsOn: [],
+        status: getServiceStatus(active, sub),
+        health: 'unknown',
+        endpoints: [],
+      };
+      
+      // Extract port from description
+      const portMatch = description.match(/port[=:]?\s*(\d+)/i);
+      if (portMatch) {
+        service.port = Number(portMatch[1]);
+      }
+      
+      // Analyze service for dependencies
+      const deps = await analyzeServiceDependencies(name, service.port);
+      service.dependsOn = deps.dependsOn;
+      service.endpoints = deps.endpoints;
+      
+      services.push(service);
+      
+      // Add edges to graph
+      for (const dep of deps.dependsOn) {
+        edges.push({
+          from: name,
+          to: dep,
+          type: deps.type,
+        });
+      }
+    }
+    
+  } catch (error) {
+    console.error('Error fetching services:', error);
+  }
+  
+  return { services, edges };
+}
+
+async function analyzeServiceDependencies(serviceName: string, port?: number): Promise<{
+  dependsOn: string[];
+  endpoints: string[];
+  type: 'http' | 'database' | 'message' | 'custom';
+}> {
+  const dependsOn: string[] = [];
+  const endpoints: string[] = [];
+  let type: 'http' | 'database' | 'message' | 'custom' = 'custom';
+  
+  try {
+    // Check if service has health endpoints
+    if (port) {
+      endpoints.push(`http://localhost:${port}/healthz`);
+      endpoints.push(`http://localhost:${port}/readyz`);
+      endpoints.push(`http://localhost:${port}/metrics`);
+      
+      // Check for common dependency patterns
+      try {
+        const response = Bun.fetch(`http://localhost:${port}/dependencies`, { timeout: 1000 });
+        if (response.ok) {
+          const deps = await response.json();
+          if (Array.isArray(deps)) {
+            dependsOn.push(...deps);
+            type = 'http';
+          }
+        }
+      } catch {
+        // Service doesn't expose dependencies endpoint
+      }
+    }
+    
+    // Analyze service files for dependency patterns
+    try {
+      const servicePath = `/home/xarhang/.config/systemd/user/${serviceName}.service`;
+      const serviceContent = Bun.file(servicePath).text();
+      
+      // Look for environment variables that suggest dependencies
+      const envMatches = serviceContent.match(/Environment=([^\n]+)/g) || [];
+      for (const env of envMatches) {
+        if (env.includes('DATABASE_URL') || env.includes('DB_HOST')) {
+          dependsOn.push('database');
+          type = 'database';
+        }
+        if (env.includes('REDIS_URL') || env.includes('REDIS_HOST')) {
+          dependsOn.push('redis');
+          type = 'message';
+        }
+        if (env.includes('API_URL') || env.includes('SERVICE_URL')) {
+          const urlMatch = env.match(/https?:\/\/([^:\/]+)/);
+          if (urlMatch) {
+            dependsOn.push(urlMatch[1]);
+            type = 'http';
+          }
+        }
+      }
+    } catch {
+      // Service file not accessible
+    }
+    
+  } catch (error) {
+    console.error(`Error analyzing dependencies for ${serviceName}:`, error);
+  }
+  
+  return { dependsOn, endpoints, type };
+}
+
+function getServiceStatus(active: string, sub: string): 'running' | 'stopped' | 'failed' | 'unknown' {
+  if (active === 'active' && sub === 'running') return 'running';
+  if (active === 'inactive') return 'stopped';
+  if (active === 'failed' || sub === 'failed') return 'failed';
+  return 'unknown';
+}
+
+function displayDependencyGraph(graph: DependencyGraph): void {
+  console.log('\n📊 Service Dependencies:');
+  console.log('-'.repeat(60));
+  
+  for (const service of graph.services) {
+    const statusIcon = getStatusIcon(service.status);
+    const healthIcon = getHealthIcon(service.health);
+    
+    console.log(`${statusIcon} ${service.name} ${healthIcon}`);
+    
+    if (service.dependsOn.length > 0) {
+      console.log(`   └─ Depends on: ${service.dependsOn.join(', ')}`);
+    }
+    
+    if (service.endpoints.length > 0) {
+      console.log(`   └─ Endpoints: ${service.endpoints.slice(0, 2).join(', ')}${service.endpoints.length > 2 ? '...' : ''}`);
+    }
+    
+    console.log('');
+  }
+  
+  console.log('\n🔗 Dependency Relationships:');
+  console.log('-'.repeat(60));
+  
+  if (graph.edges.length === 0) {
+    console.log('No dependencies found between services.');
+  } else {
+    for (const edge of graph.edges) {
+      const fromService = graph.services.find(s => s.name === edge.from);
+      const toService = graph.services.find(s => s.name === edge.to);
+      
+      const fromIcon = fromService ? getStatusIcon(fromService.status) : '❓';
+      const toIcon = toService ? getStatusIcon(toService.status) : '❓';
+      
+      console.log(`${fromIcon} ${edge.from} → ${edge.to} ${toIcon} (${edge.type})`);
+    }
+  }
+  
+  console.log('\n📈 Summary:');
+  console.log(`   Total Services: ${graph.services.length}`);
+  console.log(`   Dependencies: ${graph.edges.length}`);
+  console.log(`   Running: ${graph.services.filter(s => s.status === 'running').length}`);
+  console.log(`   Failed: ${graph.services.filter(s => s.status === 'failed').length}`);
+}
+
+function generateDotGraph(graph: DependencyGraph): string {
+  let dot = 'digraph BS9_Dependencies {\n';
+  dot += '  rankdir=LR;\n';
+  dot += '  node [shape=box, style=filled];\n\n';
+  
+  // Add nodes
+  for (const service of graph.services) {
+    const color = getNodeColor(service.status);
+    const label = `${service.name}\\n${service.status}`;
+    dot += `  "${service.name}" [label="${label}", fillcolor="${color}"];\n`;
+  }
+  
+  dot += '\n';
+  
+  // Add edges
+  for (const edge of graph.edges) {
+    const color = getEdgeColor(edge.type);
+    dot += `  "${edge.from}" -> "${edge.to}" [color="${color}", label="${edge.type}"];\n`;
+  }
+  
+  dot += '}\n';
+  
+  return dot;
+}
+
+function getStatusIcon(status: string): string {
+  switch (status) {
+    case 'running': return '✅';
+    case 'stopped': return '⏸️';
+    case 'failed': return '❌';
+    default: return '❓';
+  }
+}
+
+function getHealthIcon(health: string): string {
+  switch (health) {
+    case 'healthy': return '🟢';
+    case 'unhealthy': return '🔴';
+    default: return '⚪';
+  }
+}
+
+function getNodeColor(status: string): string {
+  switch (status) {
+    case 'running': return 'lightgreen';
+    case 'stopped': return 'lightgray';
+    case 'failed': return 'lightcoral';
+    default: return 'lightyellow';
+  }
+}
+
+function getEdgeColor(type: string): string {
+  switch (type) {
+    case 'http': return 'blue';
+    case 'database': return 'green';
+    case 'message': return 'orange';
+    default: return 'gray';
+  }
+}