@namzu/cli 29.0.0 → 29.1.0

package/dist/schedule/service/quote.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Quoting for each supervisor's file format. Paths are data; each format's
+ * special characters are escaped, never interpreted.
+ */
+/** A word in a systemd unit's `ExecStart=`: double-quoted, `%` and `$` doubled. */
+export declare function systemdWord(text: string): string;
+/** A value in a systemd `Environment=` assignment, quoted as a whole. */
+export declare function systemdAssignment(key: string, value: string): string;
+/** Text in XML content or an attribute. */
+export declare function xmlText(text: string): string;
+/**
+ * A Windows command-line argument, quoted by the rules `CommandLineToArgvW`
+ * applies: backslashes before a quote are doubled, quotes are escaped.
+ */
+export declare function windowsArgument(text: string): string;
+/**
+ * A path `wsl.exe` passes on unchanged. Its command line is re-parsed on the
+ * Linux side, so a space, `$`, a quote or a backtick would split or change
+ * it; rather than an escape layer that has to be right twice, such a path is
+ * refused.
+ */
+export declare const WSL_SAFE_PATH: RegExp;
+export declare function checkWslPath(label: string, path: string): string;
+//# sourceMappingURL=quote.d.ts.map

package/dist/schedule/service/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../../src/schedule/service/quote.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,2CAA2C;AAC3C,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBpD;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAyB,CAAA;AAEnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhE"}

package/dist/schedule/service/quote.js

@@ -0,0 +1,64 @@
+/**
+ * Quoting for each supervisor's file format. Paths are data; each format's
+ * special characters are escaped, never interpreted.
+ */
+/** A word in a systemd unit's `ExecStart=`: double-quoted, `%` and `$` doubled. */
+export function systemdWord(text) {
+    const escaped = text
+        .replaceAll('\\', '\\\\')
+        .replaceAll('"', '\\"')
+        .replaceAll('%', '%%')
+        .replaceAll('$', '$$$$');
+    return `"${escaped}"`;
+}
+/** A value in a systemd `Environment=` assignment, quoted as a whole. */
+export function systemdAssignment(key, value) {
+    return systemdWord(`${key}=${value}`);
+}
+/** Text in XML content or an attribute. */
+export function xmlText(text) {
+    return text
+        .replaceAll('&', '&')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&apos;');
+}
+/**
+ * A Windows command-line argument, quoted by the rules `CommandLineToArgvW`
+ * applies: backslashes before a quote are doubled, quotes are escaped.
+ */
+export function windowsArgument(text) {
+    if (text !== '' && !/[\s"]/.test(text))
+        return text;
+    let out = '"';
+    let slashes = 0;
+    for (const ch of text) {
+        if (ch === '\\') {
+            slashes++;
+            continue;
+        }
+        if (ch === '"') {
+            out += `${'\\'.repeat(slashes * 2 + 1)}"`;
+        }
+        else {
+            out += '\\'.repeat(slashes) + ch;
+        }
+        slashes = 0;
+    }
+    return `${out}${'\\'.repeat(slashes * 2)}"`;
+}
+/**
+ * A path `wsl.exe` passes on unchanged. Its command line is re-parsed on the
+ * Linux side, so a space, `$`, a quote or a backtick would split or change
+ * it; rather than an escape layer that has to be right twice, such a path is
+ * refused.
+ */
+export const WSL_SAFE_PATH = /^[A-Za-z0-9._/@+-]+$/;
+export function checkWslPath(label, path) {
+    if (!WSL_SAFE_PATH.test(path)) {
+        throw new Error(`${label} ${path} contains characters wsl.exe would re-read (only letters, digits and . _ / @ + - are passed through safely); install node and namzu under a plain path, or use --platform systemd-user`);
+    }
+    return path;
+}
+//# sourceMappingURL=quote.js.map

package/dist/schedule/service/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../../src/schedule/service/quote.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI;SAClB,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC;SACtB,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC;SACrB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACzB,OAAO,IAAI,OAAO,GAAG,CAAA;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,KAAa;IAC3D,OAAO,WAAW,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAA;AACtC,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,OAAO,IAAI;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC;SACzB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,IAAI,IAAI,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACnD,IAAI,GAAG,GAAG,GAAG,CAAA;IACb,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,EAAE,CAAA;YACT,SAAQ;QACT,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAChB,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAA;QAC1C,CAAC;aAAM,CAAC;YACP,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;QACjC,CAAC;QACD,OAAO,GAAG,CAAC,CAAA;IACZ,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAA;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAA;AAEnD,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,IAAY;IACvD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACd,GAAG,KAAK,IAAI,IAAI,wLAAwL,CACxM,CAAA;IACF,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC"}

package/dist/schedule/service/runner.d.ts

@@ -0,0 +1,17 @@
+/**
+ * How the installers run the supervisor's commands: argv only, never a
+ * shell, with a timeout. Injectable, so an installer is tested against a
+ * recording fake instead of this machine's service manager.
+ */
+export interface CommandResult {
+    readonly code: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export type CommandRunner = (command: string, args: readonly string[], options?: {
+    readonly timeoutMs?: number;
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}) => Promise<CommandResult>;
+export declare const runCommand: CommandRunner;
+//# sourceMappingURL=runner.d.ts.map

package/dist/schedule/service/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/schedule/service/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE;IACT,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAChC,KACG,OAAO,CAAC,aAAa,CAAC,CAAA;AAE3B,eAAO,MAAM,UAAU,EAAE,aAkBtB,CAAA"}

package/dist/schedule/service/runner.js

@@ -0,0 +1,31 @@
+/**
+ * How the installers run the supervisor's commands: argv only, never a
+ * shell, with a timeout. Injectable, so an installer is tested against a
+ * recording fake instead of this machine's service manager.
+ */
+import { execFile } from 'node:child_process';
+export const runCommand = (command, args, options = {}) => new Promise((resolve) => {
+    execFile(command, [...args], {
+        timeout: options.timeoutMs ?? 30_000,
+        windowsHide: true,
+        maxBuffer: 4 * 1024 * 1024,
+        ...(options.cwd ? { cwd: options.cwd } : {}),
+        ...(options.env ? { env: options.env } : {}),
+        encoding: 'buffer',
+    }, (error, stdout, stderr) => {
+        const code = error ? (typeof error.code === 'number' ? error.code : 127) : 0;
+        resolve({ code, stdout: decode(stdout), stderr: decode(stderr) });
+    });
+});
+/** Windows tools answer in UTF-16 or the console code page; read both. */
+function decode(buffer) {
+    if (typeof buffer === 'string')
+        return buffer;
+    if (buffer.length >= 2 && buffer[0] === 0xff && buffer[1] === 0xfe)
+        return buffer.subarray(2).toString('utf16le');
+    // UTF-16LE without a BOM: every other byte of ASCII text is zero.
+    if (buffer.length >= 4 && buffer[1] === 0 && buffer[3] === 0)
+        return buffer.toString('utf16le');
+    return buffer.toString('utf8');
+}
+//# sourceMappingURL=runner.js.map

package/dist/schedule/service/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/schedule/service/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAkB7C,MAAM,CAAC,MAAM,UAAU,GAAkB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACxE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACvB,QAAQ,CACP,OAAO,EACP,CAAC,GAAG,IAAI,CAAC,EACT;QACC,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;QACpC,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;QAC1B,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,QAAQ,EAAE,QAAQ;KAClB,EACD,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5E,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAClE,CAAC,CACD,CAAA;AACF,CAAC,CAAC,CAAA;AAEH,0EAA0E;AAC1E,SAAS,MAAM,CAAC,MAAuB;IACtC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAA;IAC7C,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI;QACjE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC9C,kEAAkE;IAClE,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC/F,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}

package/dist/schedule/service/systemd.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Linux: a systemd user unit.
+ *
+ * `Restart=always` with no start limit: a second daemon waits on standby
+ * instead of exiting, and a daemon that exits 0 after an upgrade is started
+ * again on the new code. The one exit that must not restart is a daemon
+ * finding `schedule stop`'s request: it exits `EXIT_STOP_REQUESTED`, which
+ * `RestartPreventExitStatus=` names (and `SuccessExitStatus=`, so the unit
+ * is inactive rather than failed). `schedule stop` also DISABLES the unit,
+ * and `start` enables it again, so a stopped scheduler is not started at the
+ * next login.
+ * `KillMode=process`: stopping or restarting the daemon leaves runs in
+ * progress alone; they finish, record their result and the next daemon
+ * adopts them.
+ */
+import type { CommandRunner } from './runner.js';
+export interface ServiceProgram {
+    readonly node: string;
+    readonly bin: string;
+    readonly namzuHome: string;
+}
+export declare function systemdUnitPath(name: string, env?: NodeJS.ProcessEnv, home?: string): string;
+export declare function systemdUnit(program: ServiceProgram): string;
+export interface SystemdSteps {
+    readonly run: CommandRunner;
+    readonly systemctl?: string;
+}
+export declare function installSystemd(name: string, program: ServiceProgram, steps: SystemdSteps, unitPath?: string): Promise<string[]>;
+export declare function uninstallSystemd(name: string, steps: SystemdSteps, unitPath?: string): Promise<string[]>;
+export declare function systemdState(name: string, steps: SystemdSteps): Promise<string>;
+/** Enable and start: `stop` disabled it. */
+export declare function startSystemd(name: string, steps: SystemdSteps): Promise<string[]>;
+/** Disable and stop, so the next login does not start it again. */
+export declare function stopSystemd(name: string, steps: SystemdSteps): Promise<string[]>;
+/** Whether a systemd user manager answers here. */
+export declare function systemdUserAvailable(steps: SystemdSteps): Promise<boolean>;
+//# sourceMappingURL=systemd.d.ts.map

package/dist/schedule/service/systemd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.d.ts","sourceRoot":"","sources":["../../../src/schedule/service/systemd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,SAAY,GACd,MAAM,CAGR;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAsB3D;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC3B;AAMD,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,QAAQ,SAAwB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB;AAED,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,YAAY,EACnB,QAAQ,SAAwB,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrF;AAED,4CAA4C;AAC5C,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvF;AAED,mEAAmE;AACnE,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGtF;AAED,mDAAmD;AACnD,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAIhF"}

package/dist/schedule/service/systemd.js

@@ -0,0 +1,96 @@
+/**
+ * Linux: a systemd user unit.
+ *
+ * `Restart=always` with no start limit: a second daemon waits on standby
+ * instead of exiting, and a daemon that exits 0 after an upgrade is started
+ * again on the new code. The one exit that must not restart is a daemon
+ * finding `schedule stop`'s request: it exits `EXIT_STOP_REQUESTED`, which
+ * `RestartPreventExitStatus=` names (and `SuccessExitStatus=`, so the unit
+ * is inactive rather than failed). `schedule stop` also DISABLES the unit,
+ * and `start` enables it again, so a stopped scheduler is not started at the
+ * next login.
+ * `KillMode=process`: stopping or restarting the daemon leaves runs in
+ * progress alone; they finish, record their result and the next daemon
+ * adopts them.
+ */
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { EXIT_STOP_REQUESTED } from '../daemon/exit.js';
+import { systemdAssignment, systemdWord } from './quote.js';
+export function systemdUnitPath(name, env = process.env, home = homedir()) {
+    const config = env.XDG_CONFIG_HOME || join(home, '.config');
+    return join(config, 'systemd', 'user', `${name}.service`);
+}
+export function systemdUnit(program) {
+    return [
+        '[Unit]',
+        `Description=namzu scheduler (NAMZU_HOME=${program.namzuHome.replaceAll('%', '%%')})`,
+        'Documentation=https://github.com/cogitave/namzu/blob/main/docs/cli/scheduler-service.md',
+        'StartLimitIntervalSec=0',
+        '',
+        '[Service]',
+        'Type=simple',
+        `ExecStart=${[program.node, program.bin, 'schedule', 'daemon', '--home', program.namzuHome].map(systemdWord).join(' ')}`,
+        `Environment=${systemdAssignment('NAMZU_HOME', program.namzuHome)}`,
+        'Restart=always',
+        'RestartSec=10',
+        `SuccessExitStatus=${EXIT_STOP_REQUESTED}`,
+        `RestartPreventExitStatus=${EXIT_STOP_REQUESTED}`,
+        'KillMode=process',
+        'TimeoutStopSec=20',
+        '',
+        '[Install]',
+        'WantedBy=default.target',
+        '',
+    ].join('\n');
+}
+async function systemctl(steps, ...args) {
+    return steps.run(steps.systemctl ?? 'systemctl', ['--user', ...args]);
+}
+export async function installSystemd(name, program, steps, unitPath = systemdUnitPath(name)) {
+    mkdirSync(dirname(unitPath), { recursive: true });
+    writeFileSync(unitPath, systemdUnit(program), { mode: 0o644 });
+    const problems = [];
+    for (const args of [['daemon-reload'], ['enable', '--now', `${name}.service`]]) {
+        const result = await systemctl(steps, ...args);
+        if (result.code !== 0)
+            problems.push(`systemctl --user ${args.join(' ')}: ${result.stderr.trim() || `exit ${result.code}`}`);
+    }
+    return problems;
+}
+export async function uninstallSystemd(name, steps, unitPath = systemdUnitPath(name)) {
+    const problems = [];
+    await systemctl(steps, 'disable', '--now', `${name}.service`);
+    rmSync(unitPath, { force: true });
+    await systemctl(steps, 'daemon-reload');
+    await systemctl(steps, 'reset-failed', `${name}.service`);
+    if (existsSync(unitPath))
+        problems.push(`${unitPath} is still there`);
+    const shown = await systemctl(steps, 'show', `${name}.service`, '--property=LoadState');
+    if (shown.code === 0 && /LoadState=loaded/.test(shown.stdout))
+        problems.push(`${name}.service is still loaded`);
+    return problems;
+}
+export async function systemdState(name, steps) {
+    const result = await systemctl(steps, 'is-active', `${name}.service`);
+    return result.stdout.trim() || result.stderr.trim() || 'unknown';
+}
+/** Enable and start: `stop` disabled it. */
+export async function startSystemd(name, steps) {
+    const result = await systemctl(steps, 'enable', '--now', `${name}.service`);
+    return result.code === 0 ? [] : [result.stderr.trim() || `exit ${result.code}`];
+}
+/** Disable and stop, so the next login does not start it again. */
+export async function stopSystemd(name, steps) {
+    const result = await systemctl(steps, 'disable', '--now', `${name}.service`);
+    return result.code === 0 ? [] : [result.stderr.trim() || `exit ${result.code}`];
+}
+/** Whether a systemd user manager answers here. */
+export async function systemdUserAvailable(steps) {
+    if (!existsSync('/run/systemd/system'))
+        return false;
+    const result = await systemctl(steps, 'show-environment');
+    return result.code === 0;
+}
+//# sourceMappingURL=systemd.js.map

package/dist/schedule/service/systemd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.js","sourceRoot":"","sources":["../../../src/schedule/service/systemd.ts"],"names":[],"mappings":"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"}

package/dist/schedule/service/windows-task.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Windows Task Scheduler, natively and from WSL.
+ *
+ * Two triggers: at the user's logon, and a time trigger that repeats every
+ * five minutes forever. Task Scheduler's restart-on-failure reacts to a task
+ * that fails to LAUNCH, not to a non-zero exit, so after `wsl --shutdown` or a
+ * crash only the repetition brings the daemon back. `IgnoreNew` makes a
+ * repetition a no-op while the daemon runs; `schedule stop` therefore DISABLES
+ * the task (ending it would be undone within five minutes).
+ *
+ * The task names its user (`DOMAIN\user`) on the principal and on the logon
+ * trigger: a logon trigger without one applies to every user and needs
+ * elevation to register. "Run only when the user is logged on"
+ * (InteractiveToken): WSL fails to start from a non-interactive task.
+ *
+ * `schtasks /XML` reads UTF-16; the file is written UTF-16LE with a BOM to
+ * match its declaration.
+ */
+export interface TaskDefinition {
+    /** `DOMAIN\user`, from `whoami.exe`. */
+    readonly userId: string;
+    readonly description: string;
+    /** Windows path of the program. */
+    readonly command: string;
+    readonly args: readonly string[];
+    /** When the repetition starts; any past instant. */
+    readonly startBoundary?: string;
+}
+export declare function taskXml(task: TaskDefinition): string;
+/** The task file's bytes: UTF-16LE with a byte-order mark. */
+export declare function taskXmlBytes(xml: string): Buffer;
+/** The task's path in the scheduler's library. */
+export declare function taskPath(name: string): string;
+/**
+ * Delete the `\namzu` Task Scheduler folder that `/Create` made, when no
+ * task (hidden ones included) and no subfolder is left in it. `schtasks
+ * /Delete` removes a task and never its folder, and `schtasks /Query` does not
+ * show an empty folder, so without this an uninstall left one behind.
+ * Exits 1 only when the folder is still there and empty. A constant: nothing
+ * is interpolated into it.
+ */
+export declare const REMOVE_EMPTY_TASK_FOLDER_SCRIPT: string;
+/** `powershell.exe` arguments that run {@link REMOVE_EMPTY_TASK_FOLDER_SCRIPT}. */
+export declare function removeEmptyTaskFolderArguments(): string[];
+/** `schtasks /Query … /FO LIST /V` → the fields a status line needs. */
+export declare function parseTaskQuery(output: string): {
+    status?: string;
+    state?: string;
+    lastResult?: string;
+};
+//# sourceMappingURL=windows-task.d.ts.map

package/dist/schedule/service/windows-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-task.d.ts","sourceRoot":"","sources":["../../../src/schedule/service/windows-task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,cAAc;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CA0DpD;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,+BAA+B,QAQhC,CAAA;AAEZ,mFAAmF;AACnF,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CASzD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAgBA"}

package/dist/schedule/service/windows-task.js

@@ -0,0 +1,134 @@
+/**
+ * Windows Task Scheduler, natively and from WSL.
+ *
+ * Two triggers: at the user's logon, and a time trigger that repeats every
+ * five minutes forever. Task Scheduler's restart-on-failure reacts to a task
+ * that fails to LAUNCH, not to a non-zero exit, so after `wsl --shutdown` or a
+ * crash only the repetition brings the daemon back. `IgnoreNew` makes a
+ * repetition a no-op while the daemon runs; `schedule stop` therefore DISABLES
+ * the task (ending it would be undone within five minutes).
+ *
+ * The task names its user (`DOMAIN\user`) on the principal and on the logon
+ * trigger: a logon trigger without one applies to every user and needs
+ * elevation to register. "Run only when the user is logged on"
+ * (InteractiveToken): WSL fails to start from a non-interactive task.
+ *
+ * `schtasks /XML` reads UTF-16; the file is written UTF-16LE with a BOM to
+ * match its declaration.
+ */
+import { windowsArgument, xmlText } from './quote.js';
+export function taskXml(task) {
+    const start = task.startBoundary ?? '2026-01-01T00:00:00';
+    return [
+        '<?xml version="1.0" encoding="UTF-16"?>',
+        '<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">',
+        '  <RegistrationInfo>',
+        `    <Description>${xmlText(task.description)}</Description>`,
+        `    <Author>${xmlText(task.userId)}</Author>`,
+        '  </RegistrationInfo>',
+        '  <Triggers>',
+        '    <LogonTrigger>',
+        '      <Enabled>true</Enabled>',
+        `      <UserId>${xmlText(task.userId)}</UserId>`,
+        '    </LogonTrigger>',
+        '    <TimeTrigger>',
+        '      <Repetition>',
+        '        <Interval>PT5M</Interval>',
+        '        <StopAtDurationEnd>false</StopAtDurationEnd>',
+        '      </Repetition>',
+        `      <StartBoundary>${xmlText(start)}</StartBoundary>`,
+        '      <Enabled>true</Enabled>',
+        '    </TimeTrigger>',
+        '  </Triggers>',
+        '  <Principals>',
+        '    <Principal id="Author">',
+        `      <UserId>${xmlText(task.userId)}</UserId>`,
+        '      <LogonType>InteractiveToken</LogonType>',
+        '      <RunLevel>LeastPrivilege</RunLevel>',
+        '    </Principal>',
+        '  </Principals>',
+        '  <Settings>',
+        '    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>',
+        '    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>',
+        '    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>',
+        '    <AllowHardTerminate>true</AllowHardTerminate>',
+        '    <StartWhenAvailable>true</StartWhenAvailable>',
+        '    <RunOnlyIfNetworkAvailable>false</RunOnlyIfNetworkAvailable>',
+        '    <IdleSettings>',
+        '      <StopOnIdleEnd>false</StopOnIdleEnd>',
+        '      <RestartOnIdle>false</RestartOnIdle>',
+        '    </IdleSettings>',
+        '    <AllowStartOnDemand>true</AllowStartOnDemand>',
+        '    <Enabled>true</Enabled>',
+        '    <Hidden>false</Hidden>',
+        '    <RunOnlyIfIdle>false</RunOnlyIfIdle>',
+        '    <WakeToRun>false</WakeToRun>',
+        '    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>',
+        '    <Priority>7</Priority>',
+        '  </Settings>',
+        '  <Actions Context="Author">',
+        '    <Exec>',
+        `      <Command>${xmlText(task.command)}</Command>`,
+        `      <Arguments>${xmlText(task.args.map(windowsArgument).join(' '))}</Arguments>`,
+        '    </Exec>',
+        '  </Actions>',
+        '</Task>',
+        '',
+    ].join('\r\n');
+}
+/** The task file's bytes: UTF-16LE with a byte-order mark. */
+export function taskXmlBytes(xml) {
+    return Buffer.concat([Buffer.from([0xff, 0xfe]), Buffer.from(xml, 'utf16le')]);
+}
+/** The task's path in the scheduler's library. */
+export function taskPath(name) {
+    return `\\namzu\\${name}`;
+}
+/**
+ * Delete the `\namzu` Task Scheduler folder that `/Create` made, when no
+ * task (hidden ones included) and no subfolder is left in it. `schtasks
+ * /Delete` removes a task and never its folder, and `schtasks /Query` does not
+ * show an empty folder, so without this an uninstall left one behind.
+ * Exits 1 only when the folder is still there and empty. A constant: nothing
+ * is interpolated into it.
+ */
+export const REMOVE_EMPTY_TASK_FOLDER_SCRIPT = [
+    "$ErrorActionPreference = 'Stop'",
+    '$s = New-Object -ComObject Schedule.Service',
+    '$s.Connect()',
+    "try { $f = $s.GetFolder('\\namzu') } catch { exit 0 }",
+    'if ($f.GetTasks(1).Count -gt 0 -or $f.GetFolders(0).Count -gt 0) { exit 0 }',
+    "try { $s.GetFolder('\\').DeleteFolder('namzu', 0) } catch { exit 1 }",
+    'exit 0',
+].join('; ');
+/** `powershell.exe` arguments that run {@link REMOVE_EMPTY_TASK_FOLDER_SCRIPT}. */
+export function removeEmptyTaskFolderArguments() {
+    return [
+        '-NoProfile',
+        '-NonInteractive',
+        '-ExecutionPolicy',
+        'Bypass',
+        '-EncodedCommand',
+        Buffer.from(REMOVE_EMPTY_TASK_FOLDER_SCRIPT, 'utf16le').toString('base64'),
+    ];
+}
+/** `schtasks /Query … /FO LIST /V` → the fields a status line needs. */
+export function parseTaskQuery(output) {
+    const field = (label) => {
+        for (const line of output.split(/\r?\n/)) {
+            const match = /^([^:]+):\s*(.*)$/.exec(line);
+            if (match && label.test((match[1] ?? '').trim()))
+                return (match[2] ?? '').trim();
+        }
+        return undefined;
+    };
+    const status = field(/^Status$/i);
+    const state = field(/^Scheduled Task State$/i);
+    const lastResult = field(/^Last Result$/i);
+    return {
+        ...(status !== undefined ? { status } : {}),
+        ...(state !== undefined ? { state } : {}),
+        ...(lastResult !== undefined ? { lastResult } : {}),
+    };
+}
+//# sourceMappingURL=windows-task.js.map

package/dist/schedule/service/windows-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-task.js","sourceRoot":"","sources":["../../../src/schedule/service/windows-task.ts"],"names":[],"mappings":"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"}

package/dist/schedule/service/wsl.d.ts

@@ -0,0 +1,57 @@
+/**
+ * WSL: the daemon runs inside the distro, supervised by Windows Task
+ * Scheduler through `wsl.exe`.
+ *
+ * A distro is not running after Windows logs on until something starts it,
+ * and a systemd unit inside the distro cannot start its own distro; the
+ * `wsl.exe` process the task holds open both starts it and keeps WSL's idle
+ * shutdown away. The Windows programs are resolved once, here, from their
+ * fixed locations — never through PATH, whose `/mnt` entries make a failed
+ * lookup cost seconds — and recorded in the manifest.
+ *
+ * Refused at install: interop that does not answer, a node or CLI whose path
+ * `wsl.exe` would re-parse into something else, and a CLI running from the
+ * npx cache (it disappears).
+ */
+import type { CommandRunner } from './runner.js';
+import { type TaskDefinition, taskPath } from './windows-task.js';
+export interface WindowsTools {
+    readonly systemRoot: string;
+    readonly cmd: string;
+    readonly schtasks: string;
+    readonly powershell: string;
+    readonly whoami: string;
+    readonly conhost: string;
+    readonly wsl: string;
+}
+export declare const DEFAULT_SYSTEM32 = "/mnt/c/Windows/System32";
+export declare function windowsTools(system32?: string): WindowsTools;
+/** Interop answers: a Windows program starts and exits 0. */
+export declare function probeInterop(run: CommandRunner, tools: WindowsTools, env?: NodeJS.ProcessEnv): Promise<{
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+}>;
+/** `DOMAIN\user` of the Windows account, from `whoami.exe`. */
+export declare function windowsUser(run: CommandRunner, tools: WindowsTools): Promise<string>;
+/** A Linux path as Windows sees it, through `wslpath -w`. */
+export declare function toWindowsPath(run: CommandRunner, path: string): Promise<string>;
+/** Whether a CLI path is inside the npx cache, which is not kept. */
+export declare function isEphemeralBin(bin: string): boolean;
+export declare function wslTaskName(name: string, distro: string): string;
+/**
+ * The task that runs the daemon in the distro. `conhost.exe --headless` keeps
+ * a console window from appearing at logon.
+ */
+export declare function wslTaskDefinition(options: {
+    readonly userId: string;
+    readonly distro: string;
+    readonly linuxUser: string;
+    readonly node: string;
+    readonly bin: string;
+    readonly namzuHome: string;
+    readonly systemRoot?: string;
+}): TaskDefinition;
+export { taskPath };
+//# sourceMappingURL=wsl.d.ts.map

package/dist/schedule/service/wsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsl.d.ts","sourceRoot":"","sources":["../../../src/schedule/service/wsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,KAAK,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjE,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB;AAED,eAAO,MAAM,gBAAgB,4BAA4B,CAAA;AAEzD,wBAAgB,YAAY,CAAC,QAAQ,SAAmB,GAAG,YAAY,CAUtE;AAED,6DAA6D;AAC7D,wBAAsB,YAAY,CACjC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,YAAY,EACnB,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBvD;AAED,+DAA+D;AAC/D,wBAAsB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1F;AAED,6DAA6D;AAC7D,wBAAsB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrF;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B,GAAG,cAAc,CAiCjB;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA"}