synfull 0.0.0-stage → 0.1.0

package/frontend/dist/index.html

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="theme-color" content="#0b1220" />
+    <title>Synfull</title>
+    <script type="module" crossorigin src="/assets/index-ERXSRoTY.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-B40UafPr.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "synfull",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Local-first cross-platform host monitoring dashboard",
+  "license": "MIT",
+  "type": "commonjs",
+  "preferGlobal": true,
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "synfull": "scripts/synfull.cjs"
+  },
+  "files": [
+    "backend/app/**/*.py",
+    "backend/requirements-runtime.txt",
+    "frontend/dist",
+    "scripts/synfull.cjs",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "win32",
+    "linux"
+  ],
+  "scripts": {
+    "build": "npm --prefix frontend run build",
+    "test": "npm run test:backend && npm run test:frontend",
+    "test:backend": "python -m pytest backend/tests",
+    "test:frontend": "npm --prefix frontend run lint",
+    "prepack": "npm --prefix frontend ci && npm --prefix frontend run build"
+  },
+  "keywords": [
+    "monitoring",
+    "system-monitor",
+    "dashboard",
+    "linux",
+    "windows"
+  ]
+}

package/scripts/synfull.cjs

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+'use strict'
+
+const crypto = require('node:crypto')
+const fs = require('node:fs')
+const os = require('node:os')
+const path = require('node:path')
+const { spawn, spawnSync } = require('node:child_process')
+const ROOT = path.resolve(__dirname, '..')
+const VERSION = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).version
+const WINDOWS = process.platform === 'win32'
+function targetAccountHome() {
+  if (WINDOWS || !process.env.SUDO_USER) return os.homedir()
+  const account = spawnSync('getent', ['passwd', process.env.SUDO_USER], { encoding: 'utf8' })
+  return account.status === 0 && account.stdout.trim().split(':')[5] || os.homedir()
+}
+function effectiveHome() {
+  if (process.env.SYNFULL_HOME) return process.env.SYNFULL_HOME
+  const userHome = targetAccountHome()
+  return WINDOWS
+    ? path.join(process.env.LOCALAPPDATA || path.join(userHome, 'AppData', 'Local'), 'Synfull')
+    : path.join(process.env.XDG_DATA_HOME || path.join(userHome, '.local', 'share'), 'synfull')
+}
+const HOME = effectiveHome()
+const APP_DIR = path.join(HOME, 'app')
+const STATE_DIR = process.env.SYNFULL_STATE_DIR || (WINDOWS
+  ? path.join(process.env.LOCALAPPDATA || path.join(targetAccountHome(), 'AppData', 'Local'), 'Synfull')
+  : path.join(process.env.XDG_STATE_HOME || path.join(targetAccountHome(), '.local', 'state'), 'synfull'))
+const RUNTIME = path.join(APP_DIR, '.venv', WINDOWS ? 'Scripts' : 'bin', WINDOWS ? 'python.exe' : 'python')
+const PID_FILE = path.join(HOME, 'synfull.pid')
+const LOG_FILE = path.join(HOME, 'synfull.log')
+const CLI = path.resolve(__filename)
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, { stdio: 'inherit', windowsHide: true, ...options })
+  if (result.error) throw result.error
+  if (result.status !== 0) throw new Error(`${command} exited with status ${result.status ?? 'unknown'}`)
+}
+function pythonCommand() {
+  const candidates = WINDOWS ? [['py', ['-3']], ['python', []], ['python3', []]] : [['python3', []], ['python', []]]
+  for (const [command, prefix] of candidates) {
+    const probe = spawnSync(command, [...prefix, '-c', 'import sys; print("%d.%d" % sys.version_info[:2])'], { encoding: 'utf8', windowsHide: true })
+    if (probe.status === 0) {
+      const [major, minor] = probe.stdout.trim().split('.').map(Number)
+      if (major > 3 || (major === 3 && minor >= 10)) return { command, prefix }
+    }
+  }
+  throw new Error('Python 3.10+ was not found. Install Python and ensure it is on PATH, then run `synfull setup`.')
+}
+function ensureRuntime() {
+  if (!fs.existsSync(path.join(ROOT, 'backend', 'app')) || !fs.existsSync(path.join(ROOT, 'frontend', 'dist', 'index.html'))) {
+    throw new Error('This npm package is missing its backend or built dashboard assets.')
+  }
+  fs.mkdirSync(HOME, { recursive: true })
+  fs.mkdirSync(STATE_DIR, { recursive: true })
+  fs.mkdirSync(APP_DIR, { recursive: true })
+  for (const name of ['backend', 'frontend']) {
+    fs.cpSync(path.join(ROOT, name), path.join(APP_DIR, name), { recursive: true, force: true })
+  }
+  if (!fs.existsSync(RUNTIME)) {
+    const python = pythonCommand()
+    run(python.command, [...python.prefix, '-m', 'venv', path.join(APP_DIR, '.venv')])
+  }
+  const requirementsPath = path.join(APP_DIR, 'backend', 'requirements-runtime.txt')
+  const requirementsHash = crypto.createHash('sha256').update(fs.readFileSync(requirementsPath)).digest('hex')
+  const installedHashPath = path.join(APP_DIR, '.runtime-requirements-hash')
+  const installedHash = fs.existsSync(installedHashPath) ? fs.readFileSync(installedHashPath, 'utf8').trim() : ''
+  const dependenciesReady = spawnSync(RUNTIME, ['-c', 'import uvicorn, fastapi, pydantic_settings, sqlalchemy, psutil, docker'], { stdio: 'ignore', windowsHide: true }).status === 0
+  if (!dependenciesReady || installedHash !== requirementsHash) {
+    run(RUNTIME, ['-m', 'pip', 'install', '--disable-pip-version-check', '-r', requirementsPath])
+    fs.writeFileSync(installedHashPath, requirementsHash)
+  }
+  run(RUNTIME, ['-c', 'import uvicorn, fastapi, pydantic_settings, sqlalchemy, psutil, docker; import app.main'], {
+    cwd: APP_DIR,
+    env: { ...serverEnvironment(), PYTHONPATH: path.join(APP_DIR, 'backend') },
+  })
+}
+function serverEnvironment() {
+  return {
+    ...process.env,
+    SYNFULL_BIND_HOST: '127.0.0.1',
+    SYNFULL_BIND_PORT: process.env.SYNFULL_BIND_PORT || '8000',
+    SYNFULL_STATE_DIR: STATE_DIR,
+    SYNFULL_BOOTSTRAP_DEFAULT_ADMIN: '1',
+    PYTHONPATH: path.join(APP_DIR, 'backend'),
+  }
+}
+function startServer(foreground) {
+  ensureRuntime()
+  const args = ['-m', 'uvicorn', 'app.main:app', '--app-dir', path.join(APP_DIR, 'backend'), '--host', '127.0.0.1', '--port', process.env.SYNFULL_BIND_PORT || '8000']
+  if (foreground) {
+    const child = spawn(RUNTIME, args, { cwd: APP_DIR, env: serverEnvironment(), stdio: 'inherit', windowsHide: true })
+    child.on('exit', (code, signal) => process.exit(code ?? (signal ? 1 : 0)))
+    for (const signal of ['SIGINT', 'SIGTERM']) process.on(signal, () => child.kill(signal))
+    return
+  }
+  if (fs.existsSync(PID_FILE)) {
+    const pid = Number(fs.readFileSync(PID_FILE, 'utf8'))
+    try { process.kill(pid, 0); console.log(`Synfull is already running (PID ${pid}).`); return } catch { fs.rmSync(PID_FILE, { force: true }) }
+  }
+  const output = fs.openSync(LOG_FILE, 'a')
+  const detached = !WINDOWS
+  const child = spawn(RUNTIME, args, { cwd: APP_DIR, env: serverEnvironment(), detached, stdio: ['ignore', output, output], windowsHide: true })
+  fs.closeSync(output)
+  child.once('error', error => {
+    fs.rmSync(PID_FILE, { force: true })
+    console.error(`Synfull failed to start: ${error.message}`)
+    process.exitCode = 1
+  })
+  child.once('spawn', () => {
+    fs.writeFileSync(PID_FILE, String(child.pid))
+    console.log(`Synfull started at http://127.0.0.1:${process.env.SYNFULL_BIND_PORT || '8000'} (PID ${child.pid}).`)
+  })
+  child.unref()
+  console.log(`Logs: ${LOG_FILE}`)
+  console.log('First login: admin / admin; Synfull will require a new password before proceeding.')
+}
+function stopServer() {
+  if (!fs.existsSync(PID_FILE)) { console.log('Synfull is not running.'); return }
+  const pid = Number(fs.readFileSync(PID_FILE, 'utf8'))
+  if (WINDOWS) {
+    const result = spawnSync('taskkill.exe', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore', windowsHide: true })
+    if (result.status !== 0) console.log('Synfull process was already stopped.')
+  } else {
+    try { process.kill(-pid, 'SIGTERM') } catch { try { process.kill(pid, 'SIGTERM') } catch { console.log('Synfull process was already stopped.') } }
+  }
+  fs.rmSync(PID_FILE, { force: true })
+  console.log('Synfull stopped.')
+}
+function status() {
+  let running = false
+  let pid = ''
+  if (fs.existsSync(PID_FILE)) {
+    pid = fs.readFileSync(PID_FILE, 'utf8').trim()
+    try { process.kill(Number(pid), 0); running = true } catch { fs.rmSync(PID_FILE, { force: true }) }
+  }
+  console.log(`Synfull ${VERSION}: ${running ? `running (PID ${pid})` : 'stopped'}`)
+  console.log(`Dashboard: http://127.0.0.1:${process.env.SYNFULL_BIND_PORT || '8000'}`)
+  console.log(`Data: ${STATE_DIR}`)
+}
+function windowsTaskXml() {
+  const sid = spawnSync('whoami.exe', ['/user', '/fo', 'csv', '/nh'], { encoding: 'utf8', windowsHide: true }).stdout.match(/S-1-[0-9-]+/)
+  if (!sid) throw new Error('Could not determine the current Windows account SID.')
+  const exe = process.execPath.replace(/&/g, '&amp;').replace(/</g, '&lt;')
+  const cli = CLI.replace(/&/g, '&amp;').replace(/</g, '&lt;')
+  return `<?xml version="1.0" encoding="UTF-16"?>\n<Task version="1.4" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task"><Triggers><LogonTrigger><Enabled>true</Enabled><UserId>${sid[0]}</UserId></LogonTrigger></Triggers><Principals><Principal id="Author"><UserId>${sid[0]}</UserId><LogonType>InteractiveToken</LogonType><RunLevel>LeastPrivilege</RunLevel></Principal></Principals><Settings><MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy><DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries><StopIfGoingOnBatteries>false</StopIfGoingOnBatteries><RestartOnFailure><Interval>PT1M</Interval><Count>999</Count></RestartOnFailure><ExecutionTimeLimit>PT0S</ExecutionTimeLimit><Enabled>true</Enabled></Settings><Actions Context="Author"><Exec><Command>${exe}</Command><Arguments>"${cli}" run</Arguments><WorkingDirectory>${APP_DIR.replace(/&/g, '&amp;').replace(/</g, '&lt;')}</WorkingDirectory></Exec></Actions></Task>`
+}
+function installStartup() {
+  if (!WINDOWS && process.getuid && process.getuid() !== 0) {
+    throw new Error('Installing the system-wide boot service requires administrator permission. Re-run with sudo; the service will still run as your original user.')
+  }
+  if (!WINDOWS) {
+    const serviceUser = process.env.SUDO_USER || os.userInfo().username
+    if (serviceUser === 'root') throw new Error('Do not install Synfull as root. Re-run `sudo synfull install-service` from your normal account.')
+  }
+  ensureRuntime()
+  if (WINDOWS) {
+    const xmlPath = path.join(os.tmpdir(), `synfull-task-${process.pid}.xml`)
+    fs.writeFileSync(xmlPath, `\ufeff${windowsTaskXml()}`, 'utf16le')
+    try { run('schtasks.exe', ['/Create', '/TN', 'Synfull', '/XML', xmlPath, '/F']) } finally { fs.rmSync(xmlPath, { force: true }) }
+    console.log('Synfull will start at sign-in and restart after failures. It runs only on 127.0.0.1.')
+  } else {
+    const serviceUser = process.env.SUDO_USER || os.userInfo().username
+    fs.mkdirSync(STATE_DIR, { recursive: true })
+    run('chown', ['-R', serviceUser, HOME, STATE_DIR])
+    const escaped = value => value.replace(/\\/g, '\\\\').replace(/ /g, '\\x20').replace(/%/g, '%%')
+    const unit = `[Unit]\nDescription=Synfull local host monitoring\nAfter=network.target\n\n[Service]\nType=simple\nUser=${serviceUser}\nWorkingDirectory=${escaped(APP_DIR)}\nEnvironment=SYNFULL_BIND_HOST=127.0.0.1\nEnvironment=SYNFULL_BIND_PORT=${process.env.SYNFULL_BIND_PORT || '8000'}\nEnvironment=SYNFULL_STATE_DIR=${escaped(STATE_DIR)}\nEnvironment=SYNFULL_BOOTSTRAP_DEFAULT_ADMIN=1\nEnvironment=PYTHONPATH=${escaped(path.join(APP_DIR, 'backend'))}\nExecStart=${escaped(RUNTIME)} -m uvicorn app.main:app --app-dir ${escaped(path.join(APP_DIR, 'backend'))} --host 127.0.0.1 --port ${process.env.SYNFULL_BIND_PORT || '8000'}\nRestart=always\nRestartSec=3\n\n[Install]\nWantedBy=multi-user.target\n`
+    const unitPath = '/etc/systemd/system/synfull-npm.service'
+    fs.writeFileSync(unitPath, unit, { mode: 0o644 })
+    try { run('systemctl', ['daemon-reload']); run('systemctl', ['enable', '--now', 'synfull-npm.service']) }
+    catch (error) { fs.rmSync(unitPath, { force: true }); throw error }
+    console.log('Synfull is installed as a systemd service and starts at boot. It listens only on 127.0.0.1.')
+  }
+}
+function uninstallStartup() {
+  if (WINDOWS) run('schtasks.exe', ['/Delete', '/TN', 'Synfull', '/F'])
+  else { run('systemctl', ['disable', '--now', 'synfull-npm.service']); fs.rmSync('/etc/systemd/system/synfull-npm.service', { force: true }); run('systemctl', ['daemon-reload']) }
+  console.log('Synfull startup registration removed; application data was retained.')
+}
+function help() {
+  console.log(`Synfull ${VERSION}\n\nUsage: synfull <command>\n\nCommands:\n  setup             Prepare local runtime and install Python dependencies\n  start             Start Synfull in the background\n  run               Run Synfull in the foreground (for service managers)\n  stop              Stop a background Synfull process\n  status            Show status and local URLs\n  open              Open the local dashboard\n  install-service   Register start-at-login (Windows) or start-at-boot (Linux)\n  uninstall-service Remove startup registration without deleting data\n\nSynfull binds to localhost only by default. Override data/port with SYNFULL_STATE_DIR, SYNFULL_HOME, and SYNFULL_BIND_PORT.`)
+}
+function main() {
+  const command = process.argv[2]
+  if (command === '--version' || command === '-v') { console.log(VERSION); return }
+  if (command === '--help' || command === '-h') { help(); return }
+  if (!['win32', 'linux'].includes(process.platform)) throw new Error('Synfull npm CLI currently supports Windows and Linux.')
+  if (command === 'setup') { ensureRuntime(); console.log(`Runtime ready. Data directory: ${STATE_DIR}`) }
+  else if (command === 'start') startServer(false)
+  else if (command === 'run') startServer(true)
+  else if (command === 'stop') stopServer()
+  else if (command === 'status') status()
+  else if (command === 'open') {
+    const url = `http://127.0.0.1:${process.env.SYNFULL_BIND_PORT || '8000'}`
+    if (WINDOWS) spawn('cmd.exe', ['/c', 'start', '', url], { detached: true, stdio: 'ignore', windowsHide: true }).unref()
+    else spawn(process.platform === 'linux' ? 'xdg-open' : 'open', [url], { detached: true, stdio: 'ignore' }).unref()
+  }
+  else if (command === 'install-service') installStartup()
+  else if (command === 'uninstall-service') uninstallStartup()
+  else help()
+}
+
+if (require.main === module) {
+  try { main() } catch (error) { console.error(`Synfull: ${error.message}`); process.exitCode = 1 }
+}
+module.exports = { ensureRuntime, serverEnvironment, APP_DIR, STATE_DIR, ROOT }