machinaos 0.0.1

package/scripts/build.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform build script for MachinaOS.
+ * Works on: Windows, macOS, Linux, WSL, Git Bash
+ */
+import { execSync } from 'child_process';
+import { existsSync, copyFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+
+// Ensure Python UTF-8 encoding
+process.env.PYTHONUTF8 = '1';
+
+function run(cmd, cwd = ROOT) {
+  execSync(cmd, { cwd, stdio: 'inherit', shell: true });
+}
+
+function check(cmd) {
+  try {
+    execSync(cmd, { stdio: 'pipe', shell: true });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getVersion(cmd) {
+  try {
+    return execSync(cmd, { encoding: 'utf-8', shell: true }).trim();
+  } catch {
+    return null;
+  }
+}
+
+function log(step, msg) {
+  console.log(`[${step}] ${msg}`);
+}
+
+function npmInstall(cwd = ROOT) {
+  // Try npm ci first (fast), fall back to npm install if lock file out of sync
+  try {
+    execSync('npm ci', { cwd, stdio: 'pipe', shell: true });
+  } catch {
+    execSync('npm install', { cwd, stdio: 'inherit', shell: true });
+  }
+}
+
+// ============================================================================
+// Check Dependencies
+// ============================================================================
+
+console.log('Checking dependencies...\n');
+
+const missing = [];
+
+// Node.js
+const nodeVersion = getVersion('node --version');
+if (nodeVersion) {
+  console.log(`  Node.js: ${nodeVersion}`);
+} else {
+  missing.push('Node.js - https://nodejs.org/');
+}
+
+// npm
+const npmVersion = getVersion('npm --version');
+if (npmVersion) {
+  console.log(`  npm: ${npmVersion}`);
+} else {
+  missing.push('npm - comes with Node.js');
+}
+
+// Python
+let pyCmd = null;
+if (check('python --version')) {
+  pyCmd = 'python';
+} else if (check('python3 --version')) {
+  pyCmd = 'python3';
+}
+if (pyCmd) {
+  const pyVersion = getVersion(`${pyCmd} --version`);
+  console.log(`  ${pyVersion}`);
+} else {
+  missing.push('Python 3.11+ - https://python.org/');
+}
+
+// uv (Python package manager)
+const uvVersion = getVersion('uv --version');
+if (uvVersion) {
+  console.log(`  uv: ${uvVersion}`);
+} else {
+  missing.push('uv - https://docs.astral.sh/uv/getting-started/installation/');
+}
+
+// Go (required for WhatsApp server)
+const goVersionFull = getVersion('go version');
+if (goVersionFull) {
+  const goVersion = goVersionFull.match(/go\d+\.\d+(\.\d+)?/)?.[0] || 'go';
+  console.log(`  Go: ${goVersion}`);
+} else {
+  missing.push('Go - https://go.dev/dl/');
+}
+
+if (missing.length > 0) {
+  console.error('\nMissing required dependencies:\n');
+  for (const dep of missing) {
+    console.error(`  - ${dep}`);
+  }
+  console.error('\nPlease install the missing dependencies and try again.');
+  process.exit(1);
+}
+
+console.log('\nAll dependencies found.\n');
+
+// ============================================================================
+// Build
+// ============================================================================
+
+try {
+  // Step 0: Create .env if not exists
+  const envPath = resolve(ROOT, '.env');
+  const templatePath = resolve(ROOT, '.env.template');
+  if (!existsSync(envPath) && existsSync(templatePath)) {
+    copyFileSync(templatePath, envPath);
+    log('0/5', 'Created .env from template');
+  }
+
+  // Step 1: Install root dependencies
+  log('1/5', 'Installing root dependencies...');
+  npmInstall(ROOT);
+
+  // Step 2: Build client
+  log('2/5', 'Building client...');
+  run('npm run build', resolve(ROOT, 'client'));
+
+  // Step 3: Install Python dependencies
+  log('3/5', 'Installing Python dependencies...');
+  const serverDir = resolve(ROOT, 'server');
+  run('uv venv', serverDir);
+  run('uv sync', serverDir);
+
+  // Step 4: Install WhatsApp dependencies
+  log('4/5', 'Installing WhatsApp dependencies...');
+  const whatsappDir = resolve(ROOT, 'server/whatsapp-rpc');
+  npmInstall(whatsappDir);
+
+  // Step 5: Build WhatsApp server (Go binary)
+  log('5/5', 'Building WhatsApp server...');
+  run('npm run build', whatsappDir);
+
+  console.log('\nBuild complete.');
+
+} catch (err) {
+  console.error('\nBuild failed:', err.message);
+  process.exit(1);
+}

package/scripts/check-ports.ps1

@@ -0,0 +1,33 @@
+# Check port status - shows real vs orphaned TCP entries
+param(
+    [int[]]$Ports = @(3000, 3010, 9400)
+)
+
+Write-Host "Checking port status...`n"
+
+foreach ($port in $Ports) {
+    Write-Host "=== Port $port ===" -ForegroundColor Cyan
+    $connections = Get-NetTCPConnection -LocalPort $port -ErrorAction SilentlyContinue
+
+    if (-not $connections) {
+        Write-Host "  No connections" -ForegroundColor Green
+        continue
+    }
+
+    $grouped = $connections | Group-Object State
+    foreach ($group in $grouped) {
+        Write-Host "  $($group.Name): $($group.Count) connection(s)"
+    }
+
+    $processIds = $connections | Select-Object -ExpandProperty OwningProcess -Unique | Where-Object { $_ -ne 0 }
+    foreach ($procId in $processIds) {
+        $proc = Get-Process -Id $procId -ErrorAction SilentlyContinue
+        if ($proc) {
+            Write-Host "  REAL: PID $procId ($($proc.ProcessName))" -ForegroundColor Yellow
+        } else {
+            Write-Host "  ORPHAN: PID $procId (process dead, TCP entry will timeout)" -ForegroundColor DarkGray
+        }
+    }
+}
+
+Write-Host "`nNote: Orphaned entries auto-clear in 30-120 seconds. They don't block new processes."

package/scripts/clean.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform clean script using Node.js native APIs.
+ * Works on: Windows, macOS, Linux, WSL, Git Bash
+ */
+import { rmSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+
+const targets = [
+  'node_modules',
+  'client/node_modules',
+  'client/dist',
+  'client/.vite',
+  'server/whatsapp-rpc/node_modules',
+  'server/whatsapp-rpc/bin',
+  'server/whatsapp-rpc/data',
+  'server/data',
+  'server/.venv',
+];
+
+console.log('Cleaning...');
+
+for (const target of targets) {
+  const fullPath = resolve(ROOT, target);
+  if (existsSync(fullPath)) {
+    console.log(`  Removing: ${target}`);
+    try {
+      // Node.js native rmSync - works cross-platform
+      rmSync(fullPath, { recursive: true, force: true, maxRetries: 3, retryDelay: 100 });
+    } catch (err) {
+      console.log(`  Warning: Could not remove ${target}: ${err.message}`);
+    }
+  }
+}
+
+console.log('Done.');

package/scripts/docker.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+/**
+ * Docker compose wrapper that auto-enables Redis profile based on REDIS_ENABLED in .env
+ * Usage: node scripts/docker.js <command> [args...]
+ * Commands: up, down, build, logs, restart
+ */
+
+import { spawn } from 'child_process';
+import { readFileSync, existsSync, copyFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+
+// Create .env from template if it doesn't exist
+function ensureEnvFile() {
+  const envPath = resolve(ROOT, '.env');
+  if (existsSync(envPath)) return true;
+
+  const templatePath = resolve(ROOT, '.env.template');
+  if (existsSync(templatePath)) {
+    console.log('[Docker] Creating .env from .env.template');
+    copyFileSync(templatePath, envPath);
+    return true;
+  }
+
+  console.warn('[Docker] Warning: No .env or .env.template found');
+  return false;
+}
+
+// Read .env file and check REDIS_ENABLED
+function isRedisEnabled() {
+  const envPath = resolve(ROOT, '.env');
+  if (!existsSync(envPath)) return false;
+
+  const content = readFileSync(envPath, 'utf8');
+  const match = content.match(/^REDIS_ENABLED\s*=\s*(.+)$/m);
+  if (!match) return false;
+
+  const value = match[1].trim().toLowerCase();
+  return value === 'true' || value === '1' || value === 'yes';
+}
+
+// Get command and args
+const [,, command, ...args] = process.argv;
+
+if (!command) {
+  console.error('Usage: node scripts/docker.js <command> [args...]');
+  console.error('Commands: up, down, build, logs, restart');
+  process.exit(1);
+}
+
+// Ensure .env exists (create from template if needed)
+ensureEnvFile();
+
+// Build docker-compose command
+const composeArgs = [];
+
+// Add Redis profile if enabled in .env
+if (isRedisEnabled()) {
+  composeArgs.push('--profile', 'redis');
+  console.log('[Docker] Redis profile enabled (REDIS_ENABLED=true in .env)');
+} else {
+  console.log('[Docker] Redis profile disabled (REDIS_ENABLED=false in .env)');
+}
+
+// Add command
+composeArgs.push(command);
+
+// Add command-specific defaults
+if (command === 'up') {
+  composeArgs.push('-d'); // detached by default
+}
+if (command === 'logs') {
+  composeArgs.push('-f'); // follow by default
+}
+
+// Add any additional args
+composeArgs.push(...args);
+
+console.log(`[Docker] Running: docker-compose ${composeArgs.join(' ')}`);
+
+// Run docker-compose
+const proc = spawn('docker-compose', composeArgs, {
+  cwd: ROOT,
+  stdio: 'inherit',
+  shell: true
+});
+
+proc.on('exit', (code) => {
+  process.exit(code || 0);
+});

package/scripts/kill-port.ps1

@@ -0,0 +1,154 @@
+# Kill all processes using the specified ports (Windows)
+# Usage: .\kill-port.ps1 [-Ports] 3000,3010,9400
+# If no ports specified, uses default MachinaOs ports: 3000, 3010, 9400
+
+param(
+    [int[]]$Ports = @(3000, 3010, 9400)
+)
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+function Get-ProcessTree {
+    param([int]$ParentId)
+
+    $children = @()
+    $childProcesses = Get-CimInstance Win32_Process -Filter "ParentProcessId=$ParentId" -ErrorAction SilentlyContinue
+
+    foreach ($child in $childProcesses) {
+        if ($child.ProcessId -and $child.ProcessId -ne 0) {
+            $children += $child.ProcessId
+            # Recursively get grandchildren
+            $children += Get-ProcessTree -ParentId $child.ProcessId
+        }
+    }
+
+    return $children
+}
+
+function Get-PortProcesses {
+    param([int]$Port)
+
+    $pids = @()
+
+    # Method 1: Get-NetTCPConnection (preferred)
+    $connections = Get-NetTCPConnection -LocalPort $Port -ErrorAction SilentlyContinue |
+                   Where-Object { $_.State -eq 'Listen' -or $_.State -eq 'Established' }
+
+    if ($connections) {
+        $pids += $connections | Select-Object -ExpandProperty OwningProcess -Unique | Where-Object { $_ -ne 0 }
+    }
+
+    # Method 2: netstat fallback
+    if ($pids.Count -eq 0) {
+        $netstatOutput = netstat -ano 2>$null | Select-String ":$Port\s" | Select-String "LISTENING|ESTABLISHED"
+        foreach ($line in $netstatOutput) {
+            if ($line -match '\s+(\d+)\s*$') {
+                $pid = [int]$Matches[1]
+                if ($pid -ne 0 -and $pids -notcontains $pid) {
+                    $pids += $pid
+                }
+            }
+        }
+    }
+
+    return $pids | Select-Object -Unique
+}
+
+function Stop-ProcessSafely {
+    param([int]$ProcessId)
+
+    $proc = Get-Process -Id $ProcessId -ErrorAction SilentlyContinue
+    if (-not $proc) {
+        return $false
+    }
+
+    $procName = $proc.ProcessName
+
+    # Try graceful stop first
+    Stop-Process -Id $ProcessId -ErrorAction SilentlyContinue
+    Start-Sleep -Milliseconds 200
+
+    # Check if still running
+    $proc = Get-Process -Id $ProcessId -ErrorAction SilentlyContinue
+    if ($proc) {
+        # Force kill
+        Stop-Process -Id $ProcessId -Force -ErrorAction SilentlyContinue
+        Start-Sleep -Milliseconds 200
+    }
+
+    # Verify killed
+    $proc = Get-Process -Id $ProcessId -ErrorAction SilentlyContinue
+    return (-not $proc)
+}
+
+Write-Host "Stopping MachinaOs services..." -ForegroundColor Cyan
+Write-Host "Platform: Windows"
+Write-Host "Ports: $($Ports -join ', ')`n"
+
+$allStopped = $true
+
+foreach ($port in $Ports) {
+    $portPids = Get-PortProcesses -Port $port
+
+    if ($portPids.Count -eq 0) {
+        Write-Host "[OK] Port $port`: Free" -ForegroundColor Green
+        continue
+    }
+
+    # Collect all PIDs including child processes
+    $allPids = @()
+    foreach ($pid in $portPids) {
+        $allPids += $pid
+        $children = Get-ProcessTree -ParentId $pid
+        $allPids += $children
+    }
+    $allPids = $allPids | Select-Object -Unique | Where-Object { $_ -ne 0 }
+
+    $killedPids = @()
+    $failedPids = @()
+
+    # Kill all processes (children first, then parents)
+    $sortedPids = $allPids | Sort-Object -Descending
+
+    foreach ($pid in $sortedPids) {
+        $proc = Get-Process -Id $pid -ErrorAction SilentlyContinue
+        if ($proc) {
+            $procName = $proc.ProcessName
+            $killed = Stop-ProcessSafely -ProcessId $pid
+            if ($killed) {
+                $killedPids += "$pid ($procName)"
+            } else {
+                $failedPids += "$pid ($procName)"
+            }
+        }
+    }
+
+    # Verify port is free
+    Start-Sleep -Milliseconds 500
+    $remainingPids = Get-PortProcesses -Port $port
+
+    if ($remainingPids.Count -eq 0) {
+        if ($killedPids.Count -gt 0) {
+            Write-Host "[OK] Port $port`: Killed $($killedPids.Count) process(es)" -ForegroundColor Green
+            Write-Host "    PIDs: $($killedPids -join ', ')" -ForegroundColor DarkGray
+        } else {
+            Write-Host "[OK] Port $port`: Free" -ForegroundColor Green
+        }
+    } else {
+        Write-Host "[!!] Port $port`: Warning - still in use" -ForegroundColor Yellow
+        if ($killedPids.Count -gt 0) {
+            Write-Host "    Killed: $($killedPids -join ', ')" -ForegroundColor DarkGray
+        }
+        Write-Host "    Still running: $($remainingPids -join ', ')" -ForegroundColor Red
+        $allStopped = $false
+    }
+}
+
+Write-Host ""
+if ($allStopped) {
+    Write-Host "All services stopped successfully." -ForegroundColor Green
+} else {
+    Write-Host "Warning: Some ports may still be in use." -ForegroundColor Yellow
+    Write-Host "Try running as Administrator or manually kill the processes." -ForegroundColor Yellow
+    exit 1
+}

package/scripts/start.js

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+/**
+ * Cross-platform start script for MachinaOS services.
+ * Works on: Windows, macOS, Linux, WSL, Git Bash
+ */
+import { execSync, spawn } from 'child_process';
+import { readFileSync, existsSync, copyFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const START_TIME = Date.now();
+
+// ============================================================================
+// Platform Detection
+// ============================================================================
+const isWindows = process.platform === 'win32';
+const isGitBash = isWindows && (process.env.MSYSTEM || process.env.SHELL?.includes('bash'));
+const isMac = process.platform === 'darwin';
+const useUnixCommands = !isWindows || isGitBash;
+
+function getPlatformName() {
+  if (isGitBash) return 'Git Bash';
+  if (isWindows) return 'Windows';
+  if (isMac) return 'macOS';
+  return 'Linux';
+}
+
+// ============================================================================
+// Utilities
+// ============================================================================
+
+const elapsed = () => `${((Date.now() - START_TIME) / 1000).toFixed(2)}s`;
+const log = (msg) => console.log(`[${elapsed()}] ${msg}`);
+
+function exec(cmd, options = {}) {
+  try {
+    return execSync(cmd, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: options.timeout || 10000,
+      cwd: ROOT,
+      ...options
+    }).trim();
+  } catch {
+    return '';
+  }
+}
+
+function sleep(ms) {
+  try {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+  } catch {
+    const end = Date.now() + ms;
+    while (Date.now() < end) { /* spin */ }
+  }
+}
+
+function loadConfig() {
+  const envPath = existsSync(resolve(ROOT, '.env'))
+    ? resolve(ROOT, '.env')
+    : resolve(ROOT, '.env.template');
+
+  const env = {};
+  if (existsSync(envPath)) {
+    for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
+      const match = line.match(/^([^#=]+)=(.*)$/);
+      if (match) {
+        env[match[1].trim()] = match[2].trim().replace(/^["']|["']$/g, '');
+      }
+    }
+  }
+
+  return {
+    ports: [
+      parseInt(env.VITE_CLIENT_PORT) || 3000,
+      parseInt(env.PYTHON_BACKEND_PORT) || 3010,
+      parseInt(env.WHATSAPP_RPC_PORT) || 9400
+    ],
+    temporalEnabled: env.TEMPORAL_ENABLED?.toLowerCase() === 'true'
+  };
+}
+
+// ============================================================================
+// Port Management
+// ============================================================================
+
+function getPidsOnPort(port) {
+  const pids = new Set();
+
+  if (useUnixCommands) {
+    const output = exec(`lsof -ti:${port} -sTCP:LISTEN 2>/dev/null`);
+    for (const pid of output.split('\n')) {
+      if (pid.trim() && /^\d+$/.test(pid.trim())) {
+        pids.add(pid.trim());
+      }
+    }
+    if (pids.size === 0 && !isMac && !isGitBash) {
+      const ssOutput = exec(`ss -tlnp 2>/dev/null | grep :${port}`);
+      for (const match of ssOutput.matchAll(/pid=(\d+)/g)) {
+        pids.add(match[1]);
+      }
+    }
+  } else {
+    const output = exec(`netstat -ano | findstr :${port} | findstr LISTENING`);
+    for (const line of output.split('\n')) {
+      const parts = line.trim().split(/\s+/);
+      const pid = parts[parts.length - 1];
+      if (pid && /^\d+$/.test(pid) && pid !== '0') {
+        pids.add(pid);
+      }
+    }
+  }
+
+  return Array.from(pids);
+}
+
+function killPid(pid) {
+  if (useUnixCommands) {
+    exec(`kill -15 ${pid} 2>/dev/null`);
+    sleep(100);
+    exec(`kill -9 ${pid} 2>/dev/null`);
+  } else {
+    exec(`taskkill /PID ${pid} /F 2>nul`);
+  }
+}
+
+function freePort(port) {
+  const pids = getPidsOnPort(port);
+  if (pids.length === 0) return true;
+
+  for (const pid of pids) {
+    killPid(pid);
+  }
+  sleep(500);
+
+  return getPidsOnPort(port).length === 0;
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+const config = loadConfig();
+
+// Ensure Python UTF-8 encoding
+process.env.PYTHONUTF8 = '1';
+
+console.log('\n=== MachinaOS Starting ===\n');
+log(`Platform: ${getPlatformName()}`);
+log(`Ports: ${config.ports.join(', ')}`);
+log(`Temporal: ${config.temporalEnabled ? 'enabled' : 'disabled'}`);
+
+// Create .env if not exists
+const envPath = resolve(ROOT, '.env');
+const templatePath = resolve(ROOT, '.env.template');
+if (!existsSync(envPath) && existsSync(templatePath)) {
+  copyFileSync(templatePath, envPath);
+  log('Created .env from template');
+}
+
+// Free ports
+log('Freeing ports...');
+let allFree = true;
+for (const port of config.ports) {
+  const pids = getPidsOnPort(port);
+  if (pids.length > 0) {
+    const freed = freePort(port);
+    if (freed) {
+      log(`  Port ${port}: Freed (killed PIDs: ${pids.join(', ')})`);
+    } else {
+      log(`  Port ${port}: Warning - could not free`);
+      allFree = false;
+    }
+  } else {
+    log(`  Port ${port}: Already free`);
+  }
+}
+
+if (!allFree) {
+  log('Warning: Some ports could not be freed. Services may fail to start.');
+}
+
+// Start dev server
+log('Starting services...');
+log('Press Ctrl+C to stop (use npm run stop to kill all services)\n');
+
+const devCommand = config.temporalEnabled ? 'dev:temporal' : 'dev';
+
+// Use spawn with shell:true for cross-platform compatibility
+const proc = spawn('npm', ['run', devCommand], {
+  cwd: ROOT,
+  stdio: 'inherit',
+  shell: true,
+  env: { ...process.env, FORCE_COLOR: '1' }
+});
+
+// Handle Ctrl+C gracefully
+process.on('SIGINT', () => {
+  proc.kill('SIGINT');
+});
+process.on('SIGTERM', () => {
+  proc.kill('SIGTERM');
+});
+
+proc.on('close', (code) => {
+  console.log('\nDev server stopped.');
+  process.exit(code || 0);
+});