hacklab 0.22.3 → 26.921.2

package/dist/daily-sync.js

@@ -1,665 +0,0 @@
-import { spawn } from 'node:child_process';
-import { realpathSync } from 'node:fs';
-import { appendFile, mkdir, readFile, rm, stat, writeFile, } from 'node:fs/promises';
-import { homedir, platform } from 'node:os';
-import { dirname, join } from 'node:path';
-import { loadConfig, updateConfig } from './config.js';
-import { getSessionPath } from './session.js';
-import { bold, dim } from './ui.js';
-// Sets up (and tears down) the two OS-native background jobs: a `hacklab sync
-// --tick` every minute (the incremental one — reads only what the AI tools
-// appended since the last run) and the full `hacklab sync --quiet` once a day
-// (the repair pass, which also re-bases the tick's state). launchd on macOS, a
-// systemd user timer on Linux, Task Scheduler on Windows, and printed
-// instructions when none of those fit. The scheduled command is resolved to an
-// absolute `node <entry>` pair so a scheduler running with a bare PATH
-// (cron/launchd/systemd often have almost none) can launch it without a
-// `hacklab` shim.
-const LAUNCHD_LABEL = 'so.hacklab.sync';
-const LAUNCHD_TICK_LABEL = 'so.hacklab.tick';
-const SYSTEMD_UNIT = 'hacklab-sync';
-const SYSTEMD_TICK_UNIT = 'hacklab-tick';
-const SCHTASKS_TASK = 'hacklab-sync';
-const SCHTASKS_TICK_TASK = 'hacklab-tick';
-/** Bump when the plist/unit/wrapper templates, the log path derivation, or the
- * way the command is resolved change, so machines with the old artifacts
- * reinstall instead of keeping a schedule this version would no longer write.
- * Part of the stored fingerprint.
- *
- * 2: the scheduled node path is now the version-stable one where there is one
- * (see stableNodePath) — every existing install points at whatever
- * `process.execPath` happened to be, so they all need re-arming. */
-const TEMPLATE_VERSION = 2;
-/** Run a command without ever rejecting: resolves the exit code (127 when the
- * binary can't even be spawned, e.g. `systemctl` absent). */
-function run(cmd, args, opts = {}) {
-    return new Promise((resolve) => {
-        const child = spawn(cmd, args, { stdio: 'ignore', ...opts });
-        child.on('error', () => resolve(127));
-        child.on('close', (code) => resolve(code ?? 0));
-    });
-}
-/** The daily background job writes here; launchd/systemd also point stdout+stderr
- * at it. Lives next to the session file so it honors HACKLAB_SESSION_PATH. */
-export function syncLogPath() {
-    return join(dirname(getSessionPath()), 'sync.log');
-}
-function pausedMarkerPath() {
-    return join(dirname(getSessionPath()), 'sync-paused');
-}
-// The tick runs 1440 times a day, so the log has to be bounded even if every
-// one of those runs has something to say.
-export const SYNC_LOG_MAX_BYTES = 1_000_000;
-export const SYNC_LOG_KEEP_LINES = 200;
-/** Cut an oversized sync.log down to its last few hundred lines. Best-effort,
- * and a no-op while the log is small — which is the normal case. */
-export async function trimSyncLog(maxBytes = SYNC_LOG_MAX_BYTES, keepLines = SYNC_LOG_KEEP_LINES) {
-    try {
-        const path = syncLogPath();
-        if ((await stat(path)).size <= maxBytes)
-            return;
-        const lines = (await readFile(path, 'utf8')).split('\n');
-        const kept = lines.slice(-keepLines).join('\n');
-        await writeFile(path, kept.endsWith('\n') ? kept : `${kept}\n`, 'utf8');
-    }
-    catch {
-        // no log yet, or we can't rewrite it — either way, nothing to do
-    }
-}
-/** Append a timestamped line to the background-sync log (best-effort). */
-export async function appendSyncLog(line) {
-    try {
-        await mkdir(dirname(syncLogPath()), { recursive: true });
-        await appendFile(syncLogPath(), `${new Date().toISOString()} ${line}\n`);
-    }
-    catch {
-        // logging must never break the job
-    }
-}
-/** Record that the background sync can't continue (e.g. the session expired), so
- * the next interactive `hacklab` run can surface it. */
-export async function markSyncPaused(reason) {
-    try {
-        await mkdir(dirname(pausedMarkerPath()), { recursive: true });
-        await writeFile(pausedMarkerPath(), reason, 'utf8');
-    }
-    catch {
-        // best-effort
-    }
-}
-/** The reason the background sync is paused, or null if it isn't. */
-export async function readSyncPaused() {
-    try {
-        const reason = (await readFile(pausedMarkerPath(), 'utf8')).trim();
-        return reason.length > 0 ? reason : null;
-    }
-    catch {
-        return null;
-    }
-}
-export async function clearSyncPaused() {
-    try {
-        await rm(pausedMarkerPath(), { force: true });
-    }
-    catch {
-        // best-effort
-    }
-}
-/** realpath, or null when the path doesn't resolve (missing, dangling symlink). */
-function realOrNull(path) {
-    try {
-        return realpathSync(path);
-    }
-    catch {
-        return null;
-    }
-}
-/** Well-known absolute paths that keep pointing at the current node across an
- * upgrade. Windows has none to add: `process.execPath` there is already a
- * version-stable install location, not a per-version keg. */
-function stableNodeCandidates() {
-    if (platform() === 'win32')
-        return [];
-    const voltaHome = process.env.VOLTA_HOME;
-    const candidates = [
-        '/opt/homebrew/bin/node',
-        '/usr/local/bin/node',
-        '/usr/bin/node',
-        voltaHome ? join(voltaHome, 'bin', 'node') : null,
-        join(homedir(), '.volta', 'bin', 'node'),
-    ];
-    return [...new Set(candidates.filter((c) => c !== null))];
-}
-/**
- * An absolute path to *this* node that survives the next upgrade of it.
- *
- * `process.execPath` under a package manager is version-scoped:
- * `/opt/homebrew/Cellar/node/26.5.0/bin/node`. `brew upgrade node` relinks
- * `/opt/homebrew/bin/node` to the new keg and moves the shared libraries with
- * it, leaving the old absolute path resolving to a binary that can no longer
- * start ("Library not loaded: …/libada.3.dylib"). A scheduler holding that path
- * dies silently, which is exactly what happened.
- *
- * So: resolve each well-known stable location and take the first that is
- * *literally the same binary* as the one running now — identity by resolved
- * real path, never by version string and never by trusting the symlink blindly.
- * No match (fnm/nvm/asdf shims are per-shell and version-scoped, so they never
- * match) falls back to `process.execPath`, which is what shipped before.
- *
- * It stays an absolute path either way, never a bare `node`: launchd, systemd
- * and Task Scheduler run with almost no PATH, which is the whole reason this
- * function returns a path at all. Don't "simplify" it to `node`.
- */
-export function stableNodePath() {
-    const real = realOrNull(process.execPath);
-    if (!real)
-        return process.execPath;
-    for (const candidate of stableNodeCandidates()) {
-        if (realOrNull(candidate) === real)
-            return candidate;
-    }
-    return process.execPath;
-}
-/** Absolute `node` + the CLI's own entry script, so the scheduler doesn't depend
- * on a `hacklab` bin being on its PATH. */
-export function resolveSyncCommand() {
-    const argv1 = process.argv[1];
-    let script = argv1 ?? 'hacklab';
-    try {
-        if (argv1)
-            script = realpathSync(argv1);
-    }
-    catch {
-        // argv1 not resolvable (unusual) — fall back to the raw path.
-    }
-    return { node: stableNodePath(), script };
-}
-/** Identity of what the jobs were installed with: the command they run plus the
- * template generation that produced them. Stored after a successful install so a
- * later run can tell an up-to-date schedule from one worth replacing. */
-export function syncCommandFingerprint(cmd) {
-    // JSON, not concatenation: a path can contain any separator we'd pick.
-    return JSON.stringify({
-        v: TEMPLATE_VERSION,
-        node: cmd.node,
-        script: cmd.script,
-    });
-}
-/** The command a stored fingerprint describes, or null when it's from an older
- * (or unrecognizable) format — which reads as "reinstall and re-record". */
-function parseFingerprint(fingerprint) {
-    if (!fingerprint)
-        return null;
-    try {
-        const parsed = JSON.parse(fingerprint);
-        if (typeof parsed !== 'object' || parsed === null)
-            return null;
-        const { v, node, script } = parsed;
-        if (v !== TEMPLATE_VERSION)
-            return null;
-        if (typeof node !== 'string' || typeof script !== 'string')
-            return null;
-        return { node, script };
-    }
-    catch {
-        return null;
-    }
-}
-async function exists(path) {
-    try {
-        await stat(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Whether the command the scheduler is already running still works — both halves
- * of it still on disk. A user who alternates node versions (nvm) or checkouts
- * flips the fingerprint back and forth without breaking anything, and tearing
- * the jobs down and rebuilding them on every alternation is worse than leaving a
- * working schedule alone.
- */
-async function recordedCommandUsable(record) {
-    const recorded = parseFingerprint(record.command);
-    if (!recorded)
-        return false;
-    return (await exists(recorded.node)) && (await exists(recorded.script));
-}
-/** Randomize the time so installs don't all hit the API at the same instant. */
-function randomTime() {
-    return {
-        hour: Math.floor(Math.random() * 24),
-        minute: Math.floor(Math.random() * 60),
-    };
-}
-function storedTime(record) {
-    const { hour, minute } = record ?? {};
-    const valid = (n, max) => typeof n === 'number' && Number.isInteger(n) && n >= 0 && n < max;
-    return valid(hour, 24) && valid(minute, 60)
-        ? { hour: hour, minute: minute }
-        : null;
-}
-async function loadDailySyncRecord() {
-    return (await loadConfig()).dailySync;
-}
-/** Remember this install. False when the config couldn't be written — the jobs
- * are scheduled either way, but nothing will know that next time. */
-async function saveDailySyncRecord(record) {
-    return updateConfig((config) => ({ ...config, dailySync: record }));
-}
-async function clearDailySyncRecord() {
-    // No record means nothing to clear: `logout` and `daemon off` shouldn't
-    // rewrite config.json for every user who never had a schedule.
-    await updateConfig(({ dailySync, ...rest }) => (dailySync ? rest : null));
-}
-function xmlEscape(s) {
-    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-}
-const pad2 = (n) => String(n).padStart(2, '0');
-/** The plist skeleton both jobs share — same command shape, different schedule. */
-function launchdDoc(label, cmd, mode, schedule, logPath) {
-    const args = [cmd.node, cmd.script, 'sync', mode]
-        .map((a) => `    <string>${xmlEscape(a)}</string>`)
-        .join('\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>
-  <key>Label</key>
-  <string>${label}</string>
-  <key>ProgramArguments</key>
-  <array>
-${args}
-  </array>
-${schedule}
-  <key>StandardOutPath</key>
-  <string>${xmlEscape(logPath)}</string>
-  <key>StandardErrorPath</key>
-  <string>${xmlEscape(logPath)}</string>
-  <key>ProcessType</key>
-  <string>Background</string>
-</dict>
-</plist>
-`;
-}
-export function launchdPlist(cmd, time, logPath) {
-    return launchdDoc(LAUNCHD_LABEL, cmd, '--quiet', `  <key>StartCalendarInterval</key>
-  <dict>
-    <key>Hour</key>
-    <integer>${time.hour}</integer>
-    <key>Minute</key>
-    <integer>${time.minute}</integer>
-  </dict>`, logPath);
-}
-/** The minutely tick. StartInterval (not a calendar interval) so launchd just
- * re-runs it every 60s; a tick with nothing to report exits without a request. */
-export function launchdTickPlist(cmd, logPath) {
-    return launchdDoc(LAUNCHD_TICK_LABEL, cmd, '--tick', `  <key>StartInterval</key>
-  <integer>60</integer>`, logPath);
-}
-export function systemdService(cmd) {
-    // Quote node + script so paths with spaces survive systemd's parser.
-    return `[Unit]
-Description=hacklab daily token sync
-
-[Service]
-Type=oneshot
-ExecStart="${cmd.node}" "${cmd.script}" sync --quiet
-`;
-}
-export function systemdTimer() {
-    // OnCalendar=daily with a randomized delay spreads load across users; Persistent
-    // catches up a run missed while the machine was off.
-    return `[Unit]
-Description=hacklab daily token sync
-
-[Timer]
-OnCalendar=daily
-Persistent=true
-RandomizedDelaySec=3600
-
-[Install]
-WantedBy=timers.target
-`;
-}
-export function systemdTickService(cmd) {
-    return `[Unit]
-Description=hacklab token tick
-
-[Service]
-Type=oneshot
-ExecStart="${cmd.node}" "${cmd.script}" sync --tick
-`;
-}
-export function systemdTickTimer() {
-    // OnUnitActiveSec re-arms a minute after each run finishes (so a slow tick
-    // can't stack up), OnBootSec gives the desktop a moment to settle first, and
-    // AccuracySec lets systemd batch the wakeup with others — a minutely timer is
-    // otherwise a needless drain on a laptop.
-    return `[Unit]
-Description=hacklab token tick
-
-[Timer]
-OnBootSec=2min
-OnUnitActiveSec=1min
-AccuracySec=30s
-
-[Install]
-WantedBy=timers.target
-`;
-}
-/** Where the Windows scheduled task's wrapper batch file lives. Next to the
- * session file so it honors HACKLAB_SESSION_PATH, mirroring syncLogPath(). */
-export function syncWrapperPath() {
-    return join(dirname(getSessionPath()), 'hacklab-sync.cmd');
-}
-/** The tick's own wrapper — same pattern, its own file so the two tasks can be
- * created and deleted independently. */
-export function tickWrapperPath() {
-    return join(dirname(getSessionPath()), 'hacklab-tick.cmd');
-}
-/** The batch wrapper Task Scheduler runs. schtasks' `/TR` chokes on the nested
- * quotes a full `"node" "script" …` command needs, so we point the task at this
- * one-line .cmd instead and do the quoting here, where plain-batch rules apply.
- * Output is redirected to the same sync.log the job also appends to, so a crash
- * before the CLI's own logging still leaves a trace. */
-export function schtasksWrapper(cmd, logPath) {
-    return `@echo off\r\n"${cmd.node}" "${cmd.script}" sync --quiet >> "${logPath}" 2>&1\r\n`;
-}
-/** Same wrapper for the minutely tick, logging to the same sync.log. */
-export function schtasksTickWrapper(cmd, logPath) {
-    return `@echo off\r\n"${cmd.node}" "${cmd.script}" sync --tick >> "${logPath}" 2>&1\r\n`;
-}
-/** Args for `schtasks /Create`. The `/TR` value is a single pre-quoted path;
- * spawn must run with windowsVerbatimArguments so Node doesn't re-escape it. */
-export function schtasksCreateArgs(wrapperPath, time) {
-    return [
-        '/Create',
-        '/SC',
-        'DAILY',
-        '/TN',
-        SCHTASKS_TASK,
-        '/TR',
-        `"${wrapperPath}"`,
-        '/ST',
-        `${pad2(time.hour)}:${pad2(time.minute)}`,
-        '/F',
-    ];
-}
-/** Args for `schtasks /Create` for the tick: every minute, forever. */
-export function schtasksTickCreateArgs(wrapperPath) {
-    return [
-        '/Create',
-        '/SC',
-        'MINUTE',
-        '/MO',
-        '1',
-        '/TN',
-        SCHTASKS_TICK_TASK,
-        '/TR',
-        `"${wrapperPath}"`,
-        '/F',
-    ];
-}
-// The fallback for "Linux without a systemd user manager" and "an OS we don't
-// auto-schedule on" alike, so it names no specific mechanism it tried.
-export function manualInstructions(cmd) {
-    const bin = `"${cmd.node}" "${cmd.script}"`;
-    return [
-        { cadence: 'every minute', command: `${bin} sync --tick` },
-        { cadence: 'once a day', command: `${bin} sync --quiet` },
-    ];
-}
-/** Render a ManualSchedule as ready-to-print lines: a dim explainer, then each
- * job as a dim cadence label above its bold, copy-pasteable command. Blank
- * lines separate the two commands so neither reads as a wrapped continuation of
- * the other. */
-export function formatManualSchedule(schedule) {
-    const lines = [
-        dim("Schedule these with cron, a systemd timer, or your init system's scheduler:"),
-    ];
-    for (const { cadence, command } of schedule) {
-        lines.push('', dim(`${cadence}:`), bold(command));
-    }
-    return lines;
-}
-function launchAgentPath(label) {
-    return join(homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
-}
-/** Write a plist and (re)load it. Unload first so a re-run replaces the agent
- * rather than stacking a second copy. */
-async function loadAgent(path, contents) {
-    await mkdir(dirname(path), { recursive: true });
-    await writeFile(path, contents, 'utf8');
-    await run('launchctl', ['unload', path]);
-    return run('launchctl', ['load', '-w', path]);
-}
-async function installLaunchd(cmd, logPath, time) {
-    const plistPath = launchAgentPath(LAUNCHD_LABEL);
-    const loaded = await loadAgent(plistPath, launchdPlist(cmd, time, logPath));
-    await loadAgent(launchAgentPath(LAUNCHD_TICK_LABEL), launchdTickPlist(cmd, logPath));
-    // A plist in ~/Library/LaunchAgents also loads at next login, so even if
-    // `load` fails now the agent activates then — report that honestly rather
-    // than claiming it's already running.
-    return {
-        ok: true,
-        mechanism: 'launchd',
-        tick: true,
-        detail: loaded === 0
-            ? `tick every minute, full sync daily around ${pad2(time.hour)}:${pad2(time.minute)} (${plistPath})`
-            : `installed (${plistPath}) — activates at next login`,
-    };
-}
-async function installSystemd(cmd) {
-    // systemd captures stdout/stderr in the journal (journalctl --user), so unlike
-    // launchd there's no log file to point at here.
-    // Probe the user manager before writing anything, so a box without systemd
-    // (or without a user D-Bus) gets clean manual instructions and no litter.
-    if ((await run('systemctl', ['--user', 'daemon-reload'])) !== 0) {
-        return {
-            ok: false,
-            mechanism: 'manual',
-            instructions: manualInstructions(cmd),
-        };
-    }
-    const dir = join(homedir(), '.config', 'systemd', 'user');
-    await mkdir(dir, { recursive: true });
-    await writeFile(join(dir, `${SYSTEMD_UNIT}.service`), systemdService(cmd), 'utf8');
-    await writeFile(join(dir, `${SYSTEMD_UNIT}.timer`), systemdTimer(), 'utf8');
-    await writeFile(join(dir, `${SYSTEMD_TICK_UNIT}.service`), systemdTickService(cmd), 'utf8');
-    await writeFile(join(dir, `${SYSTEMD_TICK_UNIT}.timer`), systemdTickTimer(), 'utf8');
-    await run('systemctl', ['--user', 'daemon-reload']);
-    await run('systemctl', ['--user', 'enable', '--now', `${SYSTEMD_UNIT}.timer`]);
-    await run('systemctl', [
-        '--user',
-        'enable',
-        '--now',
-        `${SYSTEMD_TICK_UNIT}.timer`,
-    ]);
-    return {
-        ok: true,
-        mechanism: 'systemd',
-        tick: true,
-        detail: `systemd user timers (${SYSTEMD_TICK_UNIT}.timer every minute, ${SYSTEMD_UNIT}.timer daily); logs in journalctl --user -u ${SYSTEMD_UNIT}. To keep them running while logged out: loginctl enable-linger`,
-    };
-}
-async function installSchtasks(cmd, time) {
-    const wrapperPath = syncWrapperPath();
-    await mkdir(dirname(wrapperPath), { recursive: true });
-    await writeFile(wrapperPath, schtasksWrapper(cmd, syncLogPath()), 'utf8');
-    await writeFile(tickWrapperPath(), schtasksTickWrapper(cmd, syncLogPath()), 'utf8');
-    // /F overwrites an existing task (idempotent re-install). Verbatim args so the
-    // pre-quoted /TR path reaches schtasks intact. A non-zero exit (e.g. schtasks
-    // absent, or policy blocks task creation) falls back to manual instructions.
-    const created = await run('schtasks', schtasksCreateArgs(wrapperPath, time), {
-        windowsVerbatimArguments: true,
-    });
-    if (created !== 0) {
-        return {
-            ok: false,
-            mechanism: 'manual',
-            instructions: manualInstructions(cmd),
-        };
-    }
-    // The daily job is the one that must exist; a refused minutely task (some
-    // policies cap task frequency) costs freshness, not the streak.
-    const tick = await run('schtasks', schtasksTickCreateArgs(tickWrapperPath()), { windowsVerbatimArguments: true });
-    return {
-        ok: true,
-        mechanism: 'schtasks',
-        tick: tick === 0,
-        detail: `${tick === 0 ? 'tick every minute, ' : ''}full sync daily around ${pad2(time.hour)}:${pad2(time.minute)} (Task Scheduler task "${SCHTASKS_TASK}")`,
-    };
-}
-/**
- * True when the OS scheduler has the background jobs. A half-install (say a
- * plist that got deleted) reads as not installed, so the next run repairs it.
- *
- * `expectTick: false` drops the tick from that expectation, for the one machine
- * that legitimately has none: a Windows box whose policy refused the minutely
- * task. Without it such a box would read as half-installed forever and reinstall
- * on every scan. Callers that don't know either way get the strict check.
- */
-export async function dailySyncInstalled({ expectTick = true, } = {}) {
-    const os = platform();
-    const tickToo = (daily, tick) => expectTick ? [daily, tick] : [daily];
-    try {
-        if (os === 'darwin') {
-            for (const label of tickToo(LAUNCHD_LABEL, LAUNCHD_TICK_LABEL)) {
-                await stat(launchAgentPath(label));
-            }
-            return true;
-        }
-        if (os === 'linux') {
-            const dir = join(homedir(), '.config', 'systemd', 'user');
-            for (const unit of tickToo(SYSTEMD_UNIT, SYSTEMD_TICK_UNIT)) {
-                await stat(join(dir, `${unit}.timer`));
-            }
-            return true;
-        }
-        if (os === 'win32') {
-            for (const task of tickToo(SCHTASKS_TASK, SCHTASKS_TICK_TASK)) {
-                if ((await run('schtasks', ['/Query', '/TN', task])) !== 0)
-                    return false;
-            }
-            return true;
-        }
-    }
-    catch {
-        // missing file / scheduler
-    }
-    return false;
-}
-/**
- * What a routine run (e.g. `scan`) should do about the background jobs:
- *
- *   'missing' — no jobs, or only half of them: install, and say so.
- *   'stale'   — jobs exist but what they run is broken or unknown: reinstall
- *               quietly.
- *   'current' — jobs exist and still work: do nothing.
- *
- * "Still work" is deliberately weaker than "match what this process would
- * install": someone alternating node versions or checkouts flips the fingerprint
- * on every run while both schedules remain perfectly runnable, and rebuilding
- * the jobs each way round would be a permanent ping-pong. Only a command that
- * has actually gone missing (or a record we can't read, which includes installs
- * predating the fingerprint) earns a reinstall.
- */
-export async function dailySyncState() {
-    const record = await loadDailySyncRecord();
-    // Only a record that saw the tick get refused excuses a missing tick job.
-    const expectTick = record?.tick !== false;
-    if (!(await dailySyncInstalled({ expectTick })))
-        return 'missing';
-    if (!record?.command)
-        return 'stale';
-    if (record.command === syncCommandFingerprint(resolveSyncCommand())) {
-        return 'current';
-    }
-    return (await recordedCommandUsable(record)) ? 'current' : 'stale';
-}
-/** Install (or refresh) both background jobs (tick + daily) for the current OS. */
-export async function installDailySync() {
-    const cmd = resolveSyncCommand();
-    try {
-        await mkdir(dirname(syncLogPath()), { recursive: true }).catch(() => undefined);
-        // Reuse the slot we picked the first time: re-rolling it on every reinstall
-        // would keep moving the user's daily sync around the clock.
-        const time = storedTime(await loadDailySyncRecord()) ?? randomTime();
-        const os = platform();
-        let result;
-        if (os === 'darwin') {
-            result = await installLaunchd(cmd, syncLogPath(), time);
-        }
-        else if (os === 'linux') {
-            // systemd does its own load-spreading (RandomizedDelaySec), so `time` is
-            // recorded but unused there.
-            result = await installSystemd(cmd);
-        }
-        else if (os === 'win32') {
-            result = await installSchtasks(cmd, time);
-        }
-        else {
-            return {
-                ok: false,
-                mechanism: 'unsupported',
-                instructions: manualInstructions(cmd),
-            };
-        }
-        if (!result.ok)
-            return result;
-        const recorded = await saveDailySyncRecord({
-            command: syncCommandFingerprint(cmd),
-            ...time,
-            tick: result.tick,
-        });
-        return { ...result, recorded };
-    }
-    catch {
-        // A failed write (permissions, read-only home, …) must not crash the command
-        // ritual — fall back to printable instructions.
-        return {
-            ok: false,
-            mechanism: 'manual',
-            instructions: manualInstructions(cmd),
-        };
-    }
-}
-/** Remove both background jobs. Best-effort and never throws, so it's safe to
- * call from `logout` whether or not they were ever installed. */
-export async function uninstallDailySync() {
-    const os = platform();
-    try {
-        if (os === 'darwin') {
-            for (const label of [LAUNCHD_LABEL, LAUNCHD_TICK_LABEL]) {
-                const plistPath = launchAgentPath(label);
-                await run('launchctl', ['unload', plistPath]);
-                await rm(plistPath, { force: true });
-            }
-        }
-        else if (os === 'linux') {
-            const dir = join(homedir(), '.config', 'systemd', 'user');
-            for (const unit of [SYSTEMD_UNIT, SYSTEMD_TICK_UNIT]) {
-                await run('systemctl', ['--user', 'disable', '--now', `${unit}.timer`]);
-                await rm(join(dir, `${unit}.timer`), { force: true });
-                await rm(join(dir, `${unit}.service`), { force: true });
-            }
-            await run('systemctl', ['--user', 'daemon-reload']);
-        }
-        else if (os === 'win32') {
-            await run('schtasks', ['/Delete', '/TN', SCHTASKS_TASK, '/F']);
-            await run('schtasks', ['/Delete', '/TN', SCHTASKS_TICK_TASK, '/F']);
-            await rm(syncWrapperPath(), { force: true });
-            await rm(tickWrapperPath(), { force: true });
-        }
-    }
-    catch {
-        // best-effort
-    }
-    // Forget the command and the slot too, so a fresh install after a re-join
-    // picks a new random time rather than resurrecting the old one.
-    await clearDailySyncRecord();
-}
-//# sourceMappingURL=daily-sync.js.map