codebase-onboarder 0.5.0 → 0.7.0

package/server/startup.js

@@ -19,27 +19,21 @@
 // Deliberately no `sudo`, no writing into launchd's system domain, and nothing
 // outside the user's own home. A login item is a convenience; it must never be
 // the thing that needs an administrator password.
-
 import { promises as fs } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-
 import { configPath } from './config.js';
-
 const HERE = path.dirname(fileURLToPath(import.meta.url));
-
 export const LABEL = 'com.onboarder.server';
 export const UNIT = 'onboarder.service';
-
 export function cliEntry() {
-  // `bin/onboarder.js` next to `server/`, whether we were run from a checkout
-  // or from a global install. The env override is what lets a test point the
-  // generated unit at a fixture instead of the real machine.
-  return process.env.ONBOARDER_CLI || path.resolve(HERE, '..', 'bin', 'onboarder.js');
+    // `bin/onboarder.js` next to `server/`, whether we were run from a checkout
+    // or from a global install. The env override is what lets a test point the
+    // generated unit at a fixture instead of the real machine.
+    return process.env.ONBOARDER_CLI || path.resolve(HERE, '..', 'bin', 'onboarder.js');
 }
-
 // The argv a login item runs.
 //
 // Note what is *not* here: `background`. launchd and systemd are already
@@ -49,24 +43,21 @@ export function cliEntry() {
 // busy port into a respawn loop. So the generated command is a plain foreground
 // `start`, and the OS owns the lifecycle from there.
 export function startupCommand(configFile = configPath(), { node = process.execPath, entry = cliEntry() } = {}) {
-  return [node, entry, 'start', '--config', configFile];
+    return [node, entry, 'start', '--config', configFile];
 }
-
 function xmlEscape(value) {
-  const map = { '<': '&lt;', '>': '&gt;', '&': '&amp;', "'": '&apos;', '"': '&quot;' };
-  return String(value).replace(/[<>&'"]/g, (c) => map[c]);
+    const map = { '<': '&lt;', '>': '&gt;', '&': '&amp;', "'": '&apos;', '"': '&quot;' };
+    return String(value).replace(/[<>&'"]/g, (c) => map[c]);
 }
-
 function argList(args) {
-  return args.map((a) => `    <string>${xmlEscape(a)}</string>`).join('\n');
+    return args.map((a) => `    <string>${xmlEscape(a)}</string>`).join('\n');
 }
-
 export function renderLaunchAgent({ configFile = configPath(), log = '', ...options } = {}) {
-  const args = startupCommand(configFile, options);
-  const streams = log
-    ? `  <key>StandardOutPath</key>\n  <string>${xmlEscape(log)}</string>\n  <key>StandardErrorPath</key>\n  <string>${xmlEscape(log)}</string>\n`
-    : '';
-  return `<?xml version="1.0" encoding="UTF-8"?>
+    const args = startupCommand(configFile, options);
+    const streams = log
+        ? `  <key>StandardOutPath</key>\n  <string>${xmlEscape(log)}</string>\n  <key>StandardErrorPath</key>\n  <string>${xmlEscape(log)}</string>\n`
+        : '';
+    return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
@@ -94,14 +85,13 @@ ${streams}  <key>EnvironmentVariables</key>
 </plist>
 `;
 }
-
 export function renderSystemdUnit({ configFile = configPath(), log = '', ...options } = {}) {
-  const args = startupCommand(configFile, options);
-  // `Restart=always` would fight `onboarder stop`: a deliberate stop must stay
-  // stopped, so only a *failed* exit is restarted. `on-failure` is the honest
-  // setting here, and `SuccessfulExit=false` above is its launchd spelling.
-  const exec = args.map((a) => (/[\s"]/.test(a) ? JSON.stringify(a) : a)).join(' ');
-  return `[Unit]
+    const args = startupCommand(configFile, options);
+    // `Restart=always` would fight `onboarder stop`: a deliberate stop must stay
+    // stopped, so only a *failed* exit is restarted. `on-failure` is the honest
+    // setting here, and `SuccessfulExit=false` above is its launchd spelling.
+    const exec = args.map((a) => (/[\s"]/.test(a) ? JSON.stringify(a) : a)).join(' ');
+    return `[Unit]
 Description=Onboarder — codebase visualizer and onboarding map
 Documentation=https://github.com/Amitpandey88/onboarder
 After=network-online.target
@@ -119,143 +109,148 @@ Environment=ONBOARDER_LAUNCH=startup
 WantedBy=default.target
 `;
 }
-
 export function renderWindowsStartup({ configFile = configPath(), log = '', ...options } = {}) {
-  const args = startupCommand(configFile, options);
-  const line = args.map((a) => `"${a}"`).join(' ');
-  return `@echo off\r\nrem Managed by "onboarder start startup". Edits are replaced.\r\nstart "" /b ${line}${log ? ` >> "${log}" 2>&1` : ''}\r\n`;
+    const args = startupCommand(configFile, options);
+    const line = args.map((a) => `"${a}"`).join(' ');
+    return `@echo off\r\nrem Managed by "onboarder start startup". Edits are replaced.\r\nstart "" /b ${line}${log ? ` >> "${log}" 2>&1` : ''}\r\n`;
 }
-
 // The target carries its own platform, so every message about it can name the
 // platform it was resolved for rather than the one this process happens to run
 // on. A test (or a future cross-platform installer) resolves a plan9 target on a
 // Mac; saying "darwin" in that error would be a lie.
 export function startupTarget({ platform = process.platform, home = os.homedir(), env = process.env } = {}) {
-  // The per-user launchd domain. The system domain needs root, which this tool
-  // never asks for.
-  const domain = `gui/${process.getuid?.() ?? 501}`;
-  if (platform === 'darwin') {
-    return {
-      kind: 'launchd',
-      platform,
-      label: LABEL,
-      path: path.join(home, 'Library', 'LaunchAgents', LABEL + '.plist'),
-      render: renderLaunchAgent,
-      load: ['launchctl', 'bootstrap', domain, '{file}'],
-      unload: ['launchctl', 'bootout', `${domain}/{label}`],
-      status: ['launchctl', 'print', `${domain}/{label}`],
-      hint: 'launchd agent in ~/Library/LaunchAgents',
-    };
-  }
-  if (platform === 'linux') {
-    const configHome = env.XDG_CONFIG_HOME || path.join(home, '.config');
-    return {
-      kind: 'systemd',
-      platform,
-      label: UNIT,
-      path: path.join(configHome, 'systemd', 'user', UNIT),
-      render: renderSystemdUnit,
-      daemonReload: ['systemctl', '--user', 'daemon-reload'],
-      load: ['systemctl', '--user', 'enable', '--now', UNIT],
-      unload: ['systemctl', '--user', 'disable', '--now', UNIT],
-      status: ['systemctl', '--user', 'is-active', UNIT],
-      hint: 'systemd --user unit (no root; starts with your session)',
-    };
-  }
-  if (platform === 'win32') {
-    const appData = env.APPDATA || path.join(home, 'AppData', 'Roaming');
-    // Native separators throughout: this string goes into a .cmd file and into
-    // the Startup folder itself, and `path.join` would emit `\` mixed with `/`
-    // — which Windows tolerates in a file path but no one should have to read.
-    return {
-      kind: 'startup-folder',
-      platform,
-      label: 'Onboarder.cmd',
-      path: [
-        appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup', 'Onboarder.cmd',
-      ].join('\\'),
-      render: renderWindowsStartup,
-      load: null,   // the file *is* the registration
-      unload: null,
-      status: null,
-      hint: 'script in the Windows Startup folder',
-    };
-  }
-  return { kind: 'unsupported', platform, label: '', path: '', render: null, load: null, unload: null, status: null, hint: '' };
+    // The per-user launchd domain. The system domain needs root, which this tool
+    // never asks for.
+    const domain = `gui/${process.getuid?.() ?? 501}`;
+    if (platform === 'darwin') {
+        return {
+            kind: 'launchd',
+            platform,
+            label: LABEL,
+            path: path.join(home, 'Library', 'LaunchAgents', LABEL + '.plist'),
+            render: renderLaunchAgent,
+            load: ['launchctl', 'bootstrap', domain, '{file}'],
+            unload: ['launchctl', 'bootout', `${domain}/{label}`],
+            status: ['launchctl', 'print', `${domain}/{label}`],
+            hint: 'launchd agent in ~/Library/LaunchAgents',
+        };
+    }
+    if (platform === 'linux') {
+        const configHome = env.XDG_CONFIG_HOME || path.join(home, '.config');
+        return {
+            kind: 'systemd',
+            platform,
+            label: UNIT,
+            path: path.join(configHome, 'systemd', 'user', UNIT),
+            render: renderSystemdUnit,
+            daemonReload: ['systemctl', '--user', 'daemon-reload'],
+            load: ['systemctl', '--user', 'enable', '--now', UNIT],
+            unload: ['systemctl', '--user', 'disable', '--now', UNIT],
+            status: ['systemctl', '--user', 'is-active', UNIT],
+            hint: 'systemd --user unit (no root; starts with your session)',
+        };
+    }
+    if (platform === 'win32') {
+        const appData = env.APPDATA || path.join(home, 'AppData', 'Roaming');
+        // Native separators throughout: this string goes into a .cmd file and into
+        // the Startup folder itself, and `path.join` would emit `\` mixed with `/`
+        // — which Windows tolerates in a file path but no one should have to read.
+        return {
+            kind: 'startup-folder',
+            platform,
+            label: 'Onboarder.cmd',
+            path: [
+                appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup', 'Onboarder.cmd',
+            ].join('\\'),
+            render: renderWindowsStartup,
+            load: null, // the file *is* the registration
+            unload: null,
+            status: null,
+            hint: 'script in the Windows Startup folder',
+        };
+    }
+    return { kind: 'unsupported', platform, label: '', path: '', render: null, load: null, unload: null, status: null, hint: '' };
 }
-
 // Substitute `{file}` / `{label}` and run without a shell — an argument is an
 // argument, never a command line somebody else gets to compose. `spawn` is
 // injected so a test can assert on the argv without touching launchd.
 function exec(argv, { spawn = spawnSync } = {}) {
-  const result = spawn(argv[0], argv.slice(1), { encoding: 'utf8' });
-  return {
-    ok: !result.error && result.status === 0,
-    status: result.status ?? null,
-    output: String(result.stdout || result.stderr || '').trim(),
-    error: result.error?.message || '',
-  };
+    const result = spawn(argv[0], argv.slice(1), { encoding: 'utf8' });
+    return {
+        ok: !result.error && result.status === 0,
+        status: result.status ?? null,
+        output: String(result.stdout || result.stderr || '').trim(),
+        error: result.error?.message || '',
+    };
 }
-
 const fill = (argv, target) => argv
-  .map((a) => a.replace('{file}', target.path).replace('{label}', target.label));
-
+    .map((a) => a.replace('{file}', target.path).replace('{label}', target.label));
 export async function startupInstalled(target = startupTarget()) {
-  if (!target.path) return false;
-  try { await fs.access(target.path); return true; } catch { return false; }
+    if (!target.path)
+        return false;
+    try {
+        await fs.access(target.path);
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
-
 export async function startupStatus(target = startupTarget(), { run = spawnSync } = {}) {
-  const installed = await startupInstalled(target);
-  let active = null;
-  if (installed && target.status) {
-    const result = exec(fill(target.status, target), { spawn: run });
-    // systemd answers `active`/`inactive` on stdout; `launchctl print` succeeds
-    // only for a job that is actually loaded. Both answer "is it live now".
-    const text = result.output.toLowerCase();
-    active = target.kind === 'systemd'
-      ? text.includes('active') && !text.includes('inactive')
-      : result.ok;
-  }
-  return {
-    kind: target.kind,
-    supported: target.kind !== 'unsupported',
-    label: target.label,
-    path: target.path,
-    installed,
-    active,
-    detail: target.kind === 'unsupported'
-      ? `no automatic-startup mechanism for ${target.platform || process.platform}`
-      : installed
-        ? (active ? `running — ${target.hint}` : `installed, not running — ${target.hint}`)
-        : 'not installed',
-    hint: target.hint,
-  };
+    const installed = await startupInstalled(target);
+    let active = null;
+    if (installed && target.status) {
+        const result = exec(fill(target.status, target), { spawn: run });
+        // systemd answers `active`/`inactive` on stdout; `launchctl print` succeeds
+        // only for a job that is actually loaded. Both answer "is it live now".
+        const text = result.output.toLowerCase();
+        active = target.kind === 'systemd'
+            ? text.includes('active') && !text.includes('inactive')
+            : result.ok;
+    }
+    return {
+        kind: target.kind,
+        supported: target.kind !== 'unsupported',
+        label: target.label,
+        path: target.path,
+        installed,
+        active,
+        detail: target.kind === 'unsupported'
+            ? `no automatic-startup mechanism for ${target.platform || process.platform}`
+            : installed
+                ? (active ? `running — ${target.hint}` : `installed, not running — ${target.hint}`)
+                : 'not installed',
+        hint: target.hint,
+    };
 }
-
 export async function installStartup({ configFile = configPath(), log = '', target = startupTarget(), run = spawnSync } = {}) {
-  if (target.kind === 'unsupported') {
-    return { ok: false, reason: `There is no automatic-startup mechanism Onboarder knows how to write on ${target.platform || process.platform}. Start it with \`onboarder start background\` from whatever your machine runs at boot.` };
-  }
-  await fs.mkdir(path.dirname(target.path), { recursive: true });
-  await fs.writeFile(target.path, target.render({ configFile, log }), { encoding: 'utf8', mode: 0o600 });
-  if (target.kind === 'systemd' && target.daemonReload) exec(fill(target.daemonReload, target), { spawn: run });
-  if (!target.load) return { ok: true, path: target.path, loaded: true, output: '' };
-  const result = exec(fill(target.load, target), { spawn: run });
-  // A unit that is already loaded is a success, not a failure — installing twice
-  // has to be idempotent, and `launchctl` says so in three different ways.
-  const already = /already (been )?(loaded|active|exists|running)|115|unit .*already/i.test(result.output);
-  if (!result.ok && !already) {
-    return { ok: false, path: target.path, output: result.output || result.error, error: result.error };
-  }
-  return { ok: true, path: target.path, loaded: true, output: result.output };
+    if (target.kind === 'unsupported') {
+        return { ok: false, reason: `There is no automatic-startup mechanism Onboarder knows how to write on ${target.platform || process.platform}. Start it with \`onboarder start background\` from whatever your machine runs at boot.` };
+    }
+    await fs.mkdir(path.dirname(target.path), { recursive: true });
+    await fs.writeFile(target.path, target.render({ configFile, log }), { encoding: 'utf8', mode: 0o600 });
+    if (target.kind === 'systemd' && target.daemonReload)
+        exec(fill(target.daemonReload, target), { spawn: run });
+    if (!target.load)
+        return { ok: true, path: target.path, loaded: true, output: '' };
+    const result = exec(fill(target.load, target), { spawn: run });
+    // A unit that is already loaded is a success, not a failure — installing twice
+    // has to be idempotent, and `launchctl` says so in three different ways.
+    const already = /already (been )?(loaded|active|exists|running)|115|unit .*already/i.test(result.output);
+    if (!result.ok && !already) {
+        return { ok: false, path: target.path, output: result.output || result.error, error: result.error };
+    }
+    return { ok: true, path: target.path, loaded: true, output: result.output };
 }
-
 export async function removeStartup({ target = startupTarget(), run = spawnSync } = {}) {
-  if (target.kind === 'unsupported') return { ok: false, reason: 'Nothing is installed for this platform.' };
-  let output = '';
-  if (target.unload) output = exec(fill(target.unload, target), { spawn: run }).output;
-  await fs.rm(target.path, { force: true });
-  if (target.kind === 'systemd' && target.daemonReload) exec(fill(target.daemonReload, target), { spawn: run });
-  return { ok: true, path: target.path, output };
-}
+    if (target.kind === 'unsupported')
+        return { ok: false, reason: 'Nothing is installed for this platform.' };
+    let output = '';
+    if (target.unload)
+        output = exec(fill(target.unload, target), { spawn: run }).output;
+    await fs.rm(target.path, { force: true });
+    if (target.kind === 'systemd' && target.daemonReload)
+        exec(fill(target.daemonReload, target), { spawn: run });
+    return { ok: true, path: target.path, output };
+}
+//# sourceMappingURL=startup.js.map

package/server/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../src/server/startup.ts"],"names":[],"mappings":"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","sourcesContent":["// Start Onboarder when the machine boots, the way a person actually wants a\n// server they always want running to behave.\n//\n// \"Startup\" is three different mechanisms wearing one name, so this module\n// detects the platform and speaks its dialect — and, importantly, the *file\n// writing* is separated from the *service loading* so both are testable without\n// a Mac or a systemd:\n//\n//   macOS    ~/Library/LaunchAgents/<label>.plist   → launchctl bootstrap\n//   Linux    ~/.config/systemd/user/<unit>.service  → systemctl --user enable --now\n//   Windows  %APPDATA%\\...\\Startup\\Onboarder.cmd   → being there is enough\n//   other    nothing; we say so rather than pretending\n//\n// Every artifact is generated from the *same* command line a person would type\n// (`<node> <cli> start background --config <file>`), so a login-started server\n// is indistinguishable from a hand-started one — same config, same pid file,\n// same `onboarder stop`.\n//\n// Deliberately no `sudo`, no writing into launchd's system domain, and nothing\n// outside the user's own home. A login item is a convenience; it must never be\n// the thing that needs an administrator password.\n\nimport { promises as fs } from 'node:fs';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { spawnSync } from 'node:child_process';\nimport { fileURLToPath } from 'node:url';\n\nimport { configPath } from './config.js';\n\nconst HERE = path.dirname(fileURLToPath(import.meta.url));\n\nexport const LABEL = 'com.onboarder.server';\nexport const UNIT = 'onboarder.service';\n\nexport function cliEntry() {\n  // `bin/onboarder.js` next to `server/`, whether we were run from a checkout\n  // or from a global install. The env override is what lets a test point the\n  // generated unit at a fixture instead of the real machine.\n  return process.env.ONBOARDER_CLI || path.resolve(HERE, '..', 'bin', 'onboarder.js');\n}\n\n// The argv a login item runs.\n//\n// Note what is *not* here: `background`. launchd and systemd are already\n// supervisors — they hold the process, restart it, and capture its output. A\n// login item that spawned a detached grandchild and exited immediately would\n// leave the supervisor watching a corpse, which defeats `KeepAlive` and turns a\n// busy port into a respawn loop. So the generated command is a plain foreground\n// `start`, and the OS owns the lifecycle from there.\nexport function startupCommand(configFile = configPath(), { node = process.execPath, entry = cliEntry() }: Record<string, any> = {}) {\n  return [node, entry, 'start', '--config', configFile];\n}\n\nfunction xmlEscape(value) {\n  const map = { '<': '&lt;', '>': '&gt;', '&': '&amp;', \"'\": '&apos;', '\"': '&quot;' };\n  return String(value).replace(/[<>&'\"]/g, (c) => map[c]);\n}\n\nfunction argList(args) {\n  return args.map((a) => `    <string>${xmlEscape(a)}</string>`).join('\\n');\n}\n\nexport function renderLaunchAgent({ configFile = configPath(), log = '', ...options }: Record<string, any> = {}) {\n  const args = startupCommand(configFile, options);\n  const streams = log\n    ? `  <key>StandardOutPath</key>\\n  <string>${xmlEscape(log)}</string>\\n  <key>StandardErrorPath</key>\\n  <string>${xmlEscape(log)}</string>\\n`\n    : '';\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"http://www.apple.com/DTDs/PropertyList-1.0.dtd\">\n<plist version=\"1.0\">\n<dict>\n  <key>Label</key>\n  <string>${xmlEscape(LABEL)}</string>\n  <key>ProgramArguments</key>\n  <array>\n${argList(args)}\n  </array>\n  <key>RunAtLoad</key>\n  <true/>\n  <key>KeepAlive</key>\n  <dict>\n    <key>SuccessfulExit</key>\n    <false/>\n  </dict>\n${streams}  <key>EnvironmentVariables</key>\n  <dict>\n    <key>PATH</key>\n    <string>${xmlEscape(process.env.PATH || '/usr/local/bin:/usr/bin:/bin')}</string>\n    <key>ONBOARDER_LAUNCH</key>\n    <string>startup</string>\n  </dict>\n</dict>\n</plist>\n`;\n}\n\nexport function renderSystemdUnit({ configFile = configPath(), log = '', ...options }: Record<string, any> = {}) {\n  const args = startupCommand(configFile, options);\n  // `Restart=always` would fight `onboarder stop`: a deliberate stop must stay\n  // stopped, so only a *failed* exit is restarted. `on-failure` is the honest\n  // setting here, and `SuccessfulExit=false` above is its launchd spelling.\n  const exec = args.map((a) => (/[\\s\"]/.test(a) ? JSON.stringify(a) : a)).join(' ');\n  return `[Unit]\nDescription=Onboarder — codebase visualizer and onboarding map\nDocumentation=https://github.com/Amitpandey88/onboarder\nAfter=network-online.target\nWants=network-online.target\n\n[Service]\nType=simple\nExecStart=${exec}\nRestart=on-failure\nRestartSec=3\n${log ? `StandardOutput=append:${log}\\nStandardError=append:${log}\\n` : ''}Environment=NO_COLOR=1\nEnvironment=ONBOARDER_LAUNCH=startup\n\n[Install]\nWantedBy=default.target\n`;\n}\n\nexport function renderWindowsStartup({ configFile = configPath(), log = '', ...options }: Record<string, any> = {}) {\n  const args = startupCommand(configFile, options);\n  const line = args.map((a) => `\"${a}\"`).join(' ');\n  return `@echo off\\r\\nrem Managed by \"onboarder start startup\". Edits are replaced.\\r\\nstart \"\" /b ${line}${log ? ` >> \"${log}\" 2>&1` : ''}\\r\\n`;\n}\n\n// The target carries its own platform, so every message about it can name the\n// platform it was resolved for rather than the one this process happens to run\n// on. A test (or a future cross-platform installer) resolves a plan9 target on a\n// Mac; saying \"darwin\" in that error would be a lie.\nexport function startupTarget({ platform = process.platform, home = os.homedir(), env = process.env }: Record<string, any> = {}) {\n  // The per-user launchd domain. The system domain needs root, which this tool\n  // never asks for.\n  const domain = `gui/${process.getuid?.() ?? 501}`;\n  if (platform === 'darwin') {\n    return {\n      kind: 'launchd',\n      platform,\n      label: LABEL,\n      path: path.join(home, 'Library', 'LaunchAgents', LABEL + '.plist'),\n      render: renderLaunchAgent,\n      load: ['launchctl', 'bootstrap', domain, '{file}'],\n      unload: ['launchctl', 'bootout', `${domain}/{label}`],\n      status: ['launchctl', 'print', `${domain}/{label}`],\n      hint: 'launchd agent in ~/Library/LaunchAgents',\n    };\n  }\n  if (platform === 'linux') {\n    const configHome = env.XDG_CONFIG_HOME || path.join(home, '.config');\n    return {\n      kind: 'systemd',\n      platform,\n      label: UNIT,\n      path: path.join(configHome, 'systemd', 'user', UNIT),\n      render: renderSystemdUnit,\n      daemonReload: ['systemctl', '--user', 'daemon-reload'],\n      load: ['systemctl', '--user', 'enable', '--now', UNIT],\n      unload: ['systemctl', '--user', 'disable', '--now', UNIT],\n      status: ['systemctl', '--user', 'is-active', UNIT],\n      hint: 'systemd --user unit (no root; starts with your session)',\n    };\n  }\n  if (platform === 'win32') {\n    const appData = env.APPDATA || path.join(home, 'AppData', 'Roaming');\n    // Native separators throughout: this string goes into a .cmd file and into\n    // the Startup folder itself, and `path.join` would emit `\\` mixed with `/`\n    // — which Windows tolerates in a file path but no one should have to read.\n    return {\n      kind: 'startup-folder',\n      platform,\n      label: 'Onboarder.cmd',\n      path: [\n        appData, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'Startup', 'Onboarder.cmd',\n      ].join('\\\\'),\n      render: renderWindowsStartup,\n      load: null,   // the file *is* the registration\n      unload: null,\n      status: null,\n      hint: 'script in the Windows Startup folder',\n    };\n  }\n  return { kind: 'unsupported', platform, label: '', path: '', render: null, load: null, unload: null, status: null, hint: '' };\n}\n\n// Substitute `{file}` / `{label}` and run without a shell — an argument is an\n// argument, never a command line somebody else gets to compose. `spawn` is\n// injected so a test can assert on the argv without touching launchd.\nfunction exec(argv, { spawn = spawnSync }: Record<string, any> = {}) {\n  const result = spawn(argv[0], argv.slice(1), { encoding: 'utf8' });\n  return {\n    ok: !result.error && result.status === 0,\n    status: result.status ?? null,\n    output: String(result.stdout || result.stderr || '').trim(),\n    error: result.error?.message || '',\n  };\n}\n\nconst fill = (argv, target) => argv\n  .map((a) => a.replace('{file}', target.path).replace('{label}', target.label));\n\nexport async function startupInstalled(target = startupTarget()) {\n  if (!target.path) return false;\n  try { await fs.access(target.path); return true; } catch { return false; }\n}\n\nexport async function startupStatus(target = startupTarget(), { run = spawnSync }: Record<string, any> = {}) {\n  const installed = await startupInstalled(target);\n  let active = null;\n  if (installed && target.status) {\n    const result = exec(fill(target.status, target), { spawn: run });\n    // systemd answers `active`/`inactive` on stdout; `launchctl print` succeeds\n    // only for a job that is actually loaded. Both answer \"is it live now\".\n    const text = result.output.toLowerCase();\n    active = target.kind === 'systemd'\n      ? text.includes('active') && !text.includes('inactive')\n      : result.ok;\n  }\n  return {\n    kind: target.kind,\n    supported: target.kind !== 'unsupported',\n    label: target.label,\n    path: target.path,\n    installed,\n    active,\n    detail: target.kind === 'unsupported'\n      ? `no automatic-startup mechanism for ${target.platform || process.platform}`\n      : installed\n        ? (active ? `running — ${target.hint}` : `installed, not running — ${target.hint}`)\n        : 'not installed',\n    hint: target.hint,\n  };\n}\n\nexport async function installStartup({ configFile = configPath(), log = '', target = startupTarget(), run = spawnSync }: Record<string, any> = {}) {\n  if (target.kind === 'unsupported') {\n    return { ok: false, reason: `There is no automatic-startup mechanism Onboarder knows how to write on ${target.platform || process.platform}. Start it with \\`onboarder start background\\` from whatever your machine runs at boot.` };\n  }\n  await fs.mkdir(path.dirname(target.path), { recursive: true });\n  await fs.writeFile(target.path, target.render({ configFile, log }), { encoding: 'utf8', mode: 0o600 });\n  if (target.kind === 'systemd' && target.daemonReload) exec(fill(target.daemonReload, target), { spawn: run });\n  if (!target.load) return { ok: true, path: target.path, loaded: true, output: '' };\n  const result = exec(fill(target.load, target), { spawn: run });\n  // A unit that is already loaded is a success, not a failure — installing twice\n  // has to be idempotent, and `launchctl` says so in three different ways.\n  const already = /already (been )?(loaded|active|exists|running)|115|unit .*already/i.test(result.output);\n  if (!result.ok && !already) {\n    return { ok: false, path: target.path, output: result.output || result.error, error: result.error };\n  }\n  return { ok: true, path: target.path, loaded: true, output: result.output };\n}\n\nexport async function removeStartup({ target = startupTarget(), run = spawnSync }: Record<string, any> = {}) {\n  if (target.kind === 'unsupported') return { ok: false, reason: 'Nothing is installed for this platform.' };\n  let output = '';\n  if (target.unload) output = exec(fill(target.unload, target), { spawn: run }).output;\n  await fs.rm(target.path, { force: true });\n  if (target.kind === 'systemd' && target.daemonReload) exec(fill(target.daemonReload, target), { spawn: run });\n  return { ok: true, path: target.path, output };\n}"]}

package/server/static.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveAsset(urlPath: any, { publicDir, sharedDir }: {
+    publicDir: any;
+    sharedDir: any;
+}): string;
+export declare function cacheControlFor(file: any): "no-cache" | "public, max-age=86400";
+export declare function serveStatic(res: any, urlPath: any, dirs: any): Promise<void>;

package/server/static.js

@@ -7,53 +7,50 @@
 // and work in both places, which is why browser modules reach for `/shared/...`
 // and pure logic that Node needs to test lives in `shared/` rather than beside
 // its caller.
-
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
-
 import { sendError } from './http.js';
 import { resolveInside } from './paths.js';
-
 const MIME = {
-  '.html': 'text/html; charset=utf-8',
-  '.js': 'text/javascript; charset=utf-8',
-  '.mjs': 'text/javascript; charset=utf-8',
-  '.css': 'text/css; charset=utf-8',
-  '.json': 'application/json; charset=utf-8',
-  '.svg': 'image/svg+xml',
-  '.png': 'image/png',
-  '.ico': 'image/x-icon',
-  '.map': 'application/json',
-  '.woff2': 'font/woff2',
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.ico': 'image/x-icon',
+    '.map': 'application/json',
+    '.woff2': 'font/woff2',
 };
-
 // `null` for anything that resolves outside the directory it was mapped into —
 // `resolveInside` is the traversal guard, and a request for `/../../etc/passwd`
 // has to fail here rather than reach `readFile`.
 export function resolveAsset(urlPath, { publicDir, sharedDir }) {
-  if (urlPath === '/' || urlPath === '/index.html') return path.join(publicDir, 'index.html');
-  if (urlPath.startsWith('/shared/')) return resolveInside(sharedDir, urlPath.slice('/shared/'.length));
-  return resolveInside(publicDir, urlPath);
+    if (urlPath === '/' || urlPath === '/index.html')
+        return path.join(publicDir, 'index.html');
+    if (urlPath.startsWith('/shared/'))
+        return resolveInside(sharedDir, urlPath.slice('/shared/'.length));
+    return resolveInside(publicDir, urlPath);
 }
-
 // Everything we author is served no-cache: the UI and the engine ship as loose
 // modules with no build step and no content hashes, so a stale app.js against a
 // fresh index.html breaks the whole page. Vendored builds are the exception —
 // they are versioned by the directory they sit in and never edited in place.
 export function cacheControlFor(file) {
-  return file.includes(path.sep + 'vendor' + path.sep) ? 'public, max-age=86400' : 'no-cache';
+    return file.includes(path.sep + 'vendor' + path.sep) ? 'public, max-age=86400' : 'no-cache';
 }
-
 export async function serveStatic(res, urlPath, dirs) {
-  const file = resolveAsset(urlPath, dirs);
-  if (!file) return sendError(res, 403, 'Not from here.');
-
-  const data = await fs.readFile(file).catch(() => null);
-  if (data === null) return sendError(res, 404, 'Not found: ' + urlPath);
-
-  res.writeHead(200, {
-    'content-type': MIME[path.extname(file).toLowerCase()] || 'application/octet-stream',
-    'cache-control': cacheControlFor(file),
-  });
-  res.end(data);
+    const file = resolveAsset(urlPath, dirs);
+    if (!file)
+        return sendError(res, 403, 'Not from here.');
+    const data = await fs.readFile(file).catch(() => null);
+    if (data === null)
+        return sendError(res, 404, 'Not found: ' + urlPath);
+    res.writeHead(200, {
+        'content-type': MIME[path.extname(file).toLowerCase()] || 'application/octet-stream',
+        'cache-control': cacheControlFor(file),
+    });
+    res.end(data);
 }
+//# sourceMappingURL=static.js.map

package/server/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../src/server/static.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,+EAA+E;AAC/E,cAAc;AAEd,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,IAAI,GAAG;IACX,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,yBAAyB;IACjC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,YAAY;CACvB,CAAC;AAEF,+EAA+E;AAC/E,gFAAgF;AAChF,iDAAiD;AACjD,MAAM,UAAU,YAAY,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE;IAC5D,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAC5F,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IACtG,OAAO,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,gFAAgF;AAChF,8EAA8E;AAC9E,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,IAAI;IAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,UAAU,CAAC;AAC9F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI;IAClD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAExD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;IAEvE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B;QACpF,eAAe,EAAE,eAAe,CAAC,IAAI,CAAC;KACvC,CAAC,CAAC;IACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC","sourcesContent":["// Serving the app itself: `public/` is the site root, and `/shared/` is mapped to\n// the repo's `shared/` directory so the analyzer the server imports and the\n// analyzer the browser imports are the same files. That mapping is the reason\n// nothing under `shared/` may touch `fs` or `window` — both runtimes load it.\n//\n// It also means no relative specifier can point from `public/js/` into `shared/`\n// and work in both places, which is why browser modules reach for `/shared/...`\n// and pure logic that Node needs to test lives in `shared/` rather than beside\n// its caller.\n\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport { sendError } from './http.js';\nimport { resolveInside } from './paths.js';\n\nconst MIME = {\n  '.html': 'text/html; charset=utf-8',\n  '.js': 'text/javascript; charset=utf-8',\n  '.mjs': 'text/javascript; charset=utf-8',\n  '.css': 'text/css; charset=utf-8',\n  '.json': 'application/json; charset=utf-8',\n  '.svg': 'image/svg+xml',\n  '.png': 'image/png',\n  '.ico': 'image/x-icon',\n  '.map': 'application/json',\n  '.woff2': 'font/woff2',\n};\n\n// `null` for anything that resolves outside the directory it was mapped into —\n// `resolveInside` is the traversal guard, and a request for `/../../etc/passwd`\n// has to fail here rather than reach `readFile`.\nexport function resolveAsset(urlPath, { publicDir, sharedDir }) {\n  if (urlPath === '/' || urlPath === '/index.html') return path.join(publicDir, 'index.html');\n  if (urlPath.startsWith('/shared/')) return resolveInside(sharedDir, urlPath.slice('/shared/'.length));\n  return resolveInside(publicDir, urlPath);\n}\n\n// Everything we author is served no-cache: the UI and the engine ship as loose\n// modules with no build step and no content hashes, so a stale app.js against a\n// fresh index.html breaks the whole page. Vendored builds are the exception —\n// they are versioned by the directory they sit in and never edited in place.\nexport function cacheControlFor(file) {\n  return file.includes(path.sep + 'vendor' + path.sep) ? 'public, max-age=86400' : 'no-cache';\n}\n\nexport async function serveStatic(res, urlPath, dirs) {\n  const file = resolveAsset(urlPath, dirs);\n  if (!file) return sendError(res, 403, 'Not from here.');\n\n  const data = await fs.readFile(file).catch(() => null);\n  if (data === null) return sendError(res, 404, 'Not found: ' + urlPath);\n\n  res.writeHead(200, {\n    'content-type': MIME[path.extname(file).toLowerCase()] || 'application/octet-stream',\n    'cache-control': cacheControlFor(file),\n  });\n  res.end(data);\n}\n"]}

package/server/tools/install.d.ts

@@ -0,0 +1,4 @@
+export declare function plansFor(toolId: any, platform?: NodeJS.Platform): any;
+export declare function planAvailability(toolId: any, options?: Record<string, any>): any;
+export declare function isInstalling(toolId: any): boolean;
+export declare function installTool(toolId: any, onEvent?: (event: Record<string, unknown>) => void): Promise<any>;