adispatchd 0.0.0-stage → 0.1.0

package/dist/cli/program.js

@@ -0,0 +1,133 @@
+/**
+ * Command-line interface definition (Spec §4, §14, §19). The command tree is
+ * declared here; the behaviour lives in injectable handlers (see `main.ts`).
+ */
+import { Command } from 'commander';
+import { APP_VERSION } from '../app.js';
+/** Exit code used by commands that are not implemented yet. */
+export const EXIT_NOT_IMPLEMENTED = 70;
+/** CLI I/O bound to the real process streams. */
+export const processIo = {
+    stdout: (text) => process.stdout.write(text),
+    stderr: (text) => process.stderr.write(text),
+    setExitCode: (code) => {
+        process.exitCode = code;
+    },
+};
+const URL_HELP = 'base URL of the running instance (default: server.host/port from --config-dir, else http://127.0.0.1:8787)';
+/** Build the `adispatch` command tree. */
+export function createProgram(handlers = {}, io = processIo) {
+    const program = new Command('adispatch')
+        .description('Agent Dispatch Daemon (adispatchd) – configuration-driven orchestrator for shell processes and AI agents')
+        .version(APP_VERSION)
+        .option('--config-dir <path>', 'configuration directory (config.yaml, sources.yaml, workflows/, ...)')
+        .option('--data-dir <path>', 'data directory (SQLite database, logs, runs, workspaces)')
+        .configureOutput({ writeOut: io.stdout, writeErr: io.stderr })
+        .showHelpAfterError()
+        .addHelpText('after', [
+        '',
+        'All commands:',
+        '  init                          create config-dir and data-dir with an example configuration',
+        '  start                         start the orchestrator (foreground)',
+        '  status                        show the status of the running instance',
+        '  pause | resume                pause/resume automatic starts of the running instance',
+        '  drain                         finish active runs, start nothing new, then stop',
+        '  cancel-all                    cancel all runs (on_cancel), then stop',
+        '  config validate               validate the configuration offline',
+        '  config reload                 reload the configuration of the running instance',
+        '  workflow dry-run <workflow>   show candidate selection without starting anything',
+        '  service install               install the systemd service (Linux)',
+        '  service status                show the systemd service status',
+        '  service uninstall             remove the systemd service',
+        '',
+        'Docs: README.md, docs/operations.md, docs/worker-protocol.md, docs/api.md',
+        '',
+    ].join('\n'));
+    const run = (name, handler) => async (...args) => {
+        const cmd = args[args.length - 1];
+        if (!handler) {
+            io.stderr(`adispatch: "${name}" is not implemented yet\n`);
+            io.setExitCode(EXIT_NOT_IMPLEMENTED);
+            return;
+        }
+        io.setExitCode(await handler(cmd.optsWithGlobals()));
+    };
+    program
+        .command('init')
+        .description('create config-dir and data-dir with a commented example configuration (never overwrites files)')
+        .option('--port <port>', 'server.port for a newly created config.yaml (default 8787)')
+        .action(run('init', handlers.init));
+    program
+        .command('start')
+        .description('start the orchestrator (scheduler, HTTP API and web UI) in the foreground')
+        .option('--drain-timeout <duration>', 'on SIGTERM/SIGINT: wait this long for active runs before cancelling them', '10m')
+        .option('--cancel-timeout <duration>', 'time for cancelled runs incl. on_cancel before hooks are interrupted', '2m')
+        .option('--host <host>', 'override server.host')
+        .option('--port <port>', 'override server.port')
+        .action(run('start', handlers.start));
+    const control = (name, description, handler) => program
+        .command(name)
+        .description(description)
+        .option('--url <url>', URL_HELP)
+        .option('--json', 'print the JSON response')
+        .action(run(name, handler));
+    control('status', 'show scheduler state, limits, usage and counters of the running instance', handlers.status);
+    control('pause', 'pause automatic starts (running runs and manual starts are not affected)', handlers.pause);
+    control('resume', 'resume automatic starts', handlers.resume);
+    control('drain', 'start nothing new, let active runs finish, then stop the instance (exit 0)', handlers.drain)
+        .option('--wait', 'wait until the instance has stopped')
+        .option('--timeout <duration>', 'maximum wait time with --wait');
+    control('cancel-all', 'cancel all active runs (on_cancel runs), then stop the instance (exit 0)', handlers.cancelAll)
+        .option('--reason <text>', 'reason recorded for the cancelled runs')
+        .option('--wait', 'wait until the instance has stopped')
+        .option('--timeout <duration>', 'maximum wait time with --wait');
+    const config = program.command('config').description('configuration commands');
+    config
+        .command('validate')
+        .description('validate the configuration offline (syntax, schema, references, placeholders)')
+        .action(run('config validate', handlers.configValidate));
+    config
+        .command('reload')
+        .description('ask the running instance to reload its configuration (atomic; invalid YAML keeps the active config)')
+        .option('--url <url>', URL_HELP)
+        .option('--json', 'print the JSON response')
+        .action(run('config reload', handlers.configReload));
+    const workflow = program.command('workflow').description('workflow commands');
+    workflow
+        .command('dry-run')
+        .description('show candidate selection for a workflow without starting anything (running instance, else local)')
+        .argument('<workflow-id>', 'workflow ID')
+        .option('--json', 'print the structured result as JSON')
+        .option('--url <url>', URL_HELP)
+        .option('--local', 'always evaluate locally (needs --config-dir), even if an instance is running')
+        .action(async (workflowId, _opts, cmd) => {
+        if (!handlers.workflowDryRun) {
+            io.stderr('adispatch: "workflow dry-run" is not implemented yet\n');
+            io.setExitCode(EXIT_NOT_IMPLEMENTED);
+            return;
+        }
+        io.setExitCode(await handlers.workflowDryRun(workflowId, cmd.optsWithGlobals()));
+    });
+    const service = program.command('service').description('systemd service management (Linux)');
+    const serviceCommand = (name, description, handler) => service
+        .command(name)
+        .description(description)
+        .option('--name <unit>', 'unit name without .service', 'adispatchd')
+        .option('--unit-dir <path>', 'directory of unit files', '/etc/systemd/system')
+        .action(run(`service ${name}`, handler));
+    serviceCommand('install', 'install and enable the systemd service (needs root)', handlers.serviceInstall)
+        .option('--dry-run', 'only print the unit file and the planned steps')
+        .option('--user <name>', 'dedicated service user', 'adispatchd')
+        .option('--group <name>', 'service group (default: same as --user)')
+        .option('--create-user', 'create the service user if it does not exist')
+        .option('--node <path>', 'absolute node executable (default: the running node)')
+        .option('--entry <path>', 'absolute package entry point (default: this installation)')
+        .option('--env-file <path>', 'environment file for secrets ("none" to disable; default /etc/default/<name>)')
+        .option('--drain-timeout <duration>', 'drain timeout on systemctl stop', '10m')
+        .option('--cancel-timeout <duration>', 'cancel timeout after the drain timeout', '2m')
+        .option('--now', 'start the service immediately');
+    serviceCommand('status', 'show the systemd service status', handlers.serviceStatus);
+    serviceCommand('uninstall', 'stop, disable and remove the systemd unit (config and data are kept)', handlers.serviceUninstall).option('--dry-run', 'only print the planned steps');
+    return program;
+}
+//# sourceMappingURL=program.js.map

package/dist/cli/program.js.map

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

package/dist/cli/service.d.ts

@@ -0,0 +1,27 @@
+import { type SystemRunner, type UnitOptions } from '../service/index.js';
+import type { CliIo, ServiceCliOptions } from './program.js';
+/** Injectable environment (tests: platform, uid, runner – real systemd is never touched in tests). */
+export interface ServiceDeps {
+    platform?: NodeJS.Platform;
+    /** Effective UID (default `process.geteuid()`). */
+    euid?: () => number;
+    runner?: SystemRunner;
+    /** Node executable (default `process.execPath`). */
+    execPath?: string;
+    /** Package entry point of this installation (default: `main.js` next to this file). */
+    entryPath?: string;
+}
+type Io = Pick<CliIo, 'stdout' | 'stderr'>;
+/** `main.js` of this installation (`<package>/dist/cli/main.js`); in development the `.ts` source. */
+export declare function defaultEntryPath(): string;
+/** Warning if a worker's cancel grace cannot take effect within the cancel timeout. */
+export declare function cancelGraceWarning(maxCancelGraceMs: number, cancelTimeoutMs: number): string | null;
+/** Collect and validate the unit options from the CLI flags. */
+export declare function unitOptionsFromCli(opts: ServiceCliOptions, deps: ServiceDeps, io: Io): Promise<UnitOptions>;
+/** `service install`. */
+export declare function createServiceInstallHandler(io: Io, deps?: ServiceDeps): (opts: ServiceCliOptions) => Promise<number>;
+/** `service uninstall`. */
+export declare function createServiceUninstallHandler(io: Io, deps?: ServiceDeps): (opts: ServiceCliOptions) => Promise<number>;
+/** `service status`: `systemctl status <unit>` (read-only). */
+export declare function createServiceStatusHandler(io: Io, deps?: ServiceDeps): (opts: ServiceCliOptions) => Promise<number>;
+export {};

package/dist/cli/service.js

@@ -0,0 +1,252 @@
+/**
+ * `service install | status | uninstall` (Spec §4, §14, §20.1) – Linux/systemd.
+ *
+ * `install` generates the unit with absolute node and package paths (never
+ * `npx`), a dedicated user, `Restart=on-failure`, `KillMode=mixed` and a
+ * `TimeoutStopSec` derived from drain/cancel timeouts and the largest
+ * `cancel_grace` of the configuration, sets ownership/permissions of
+ * config-dir (root:<group>, 0750/0640) and data-dir (<user>, 0750), writes an
+ * environment file template (never overwrites) and enables the unit.
+ * `--dry-run` prints the unit and the planned steps without changing
+ * anything (works on every platform). On non-Linux systems the real commands
+ * refuse with an explanation.
+ *
+ * Exit codes: 0 = ok, 1 = failed, 2 = usage error / unsupported platform.
+ */
+import { existsSync, realpathSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { errorMessage, parseDuration } from '../core/index.js';
+import { loadConfig } from '../config/index.js';
+import { DEFAULT_SERVICE_USER, DEFAULT_UNIT_DIR, DEFAULT_UNIT_NAME, ServiceError, assertSafeServicePaths, formatCliDuration, executePlan, formatPlan, planInstall, planUninstall, renderSystemdUnit, systemRunner, unitFilePath, } from '../service/index.js';
+/** Default `execute.cancel_grace` (Spec defaults, WI-02). */
+const DEFAULT_APP_CANCEL_GRACE_MS = 30_000;
+/** `main.js` of this installation (`<package>/dist/cli/main.js`); in development the `.ts` source. */
+export function defaultEntryPath() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    const js = path.join(dir, 'main.js');
+    const file = existsSync(js) ? js : path.join(dir, 'main.ts');
+    try {
+        return realpathSync(file);
+    }
+    catch {
+        return file;
+    }
+}
+function unsupported(io, platform, command) {
+    io.stderr(`service ${command}: systemd service management is only supported on Linux (this is ${platform}).\n` +
+        '  On macOS run the orchestrator in the foreground: adispatch start --config-dir <dir> --data-dir <dir>\n' +
+        '  (or under launchd/your own supervisor). "service install --dry-run" prints the systemd unit anyway.\n');
+    return 2;
+}
+function duration(name, value, fallback) {
+    try {
+        return parseDuration(value ?? fallback);
+    }
+    catch (err) {
+        throw new ServiceError('service_invalid_option', `invalid --${name} "${value}": ${errorMessage(err)}`);
+    }
+}
+/**
+ * Largest `execute.cancel_grace` of the configuration. Outside dry runs the
+ * configuration must exist (`config.yaml`) and be valid – `install` changes
+ * ownership of the directory recursively, so a typo'd path must not pass.
+ * In dry runs a missing/invalid configuration only warns (default 30 s).
+ */
+async function maxCancelGrace(configDir, dataDir, io, dryRun) {
+    const configFile = path.join(configDir, 'config.yaml');
+    const exists = existsSync(configFile);
+    const loaded = exists ? await loadConfig(configDir, { dataDir }) : null;
+    if (!loaded || !loaded.ok) {
+        const why = !exists
+            ? `${configFile} does not exist (create the configuration with "adispatch init" first)`
+            : `configuration in ${configDir} is invalid (${loaded?.ok === false ? loaded.errors.length : 0} error(s); see "config validate")`;
+        if (!dryRun)
+            throw new ServiceError('service_config_invalid', why);
+        io.stderr(`warning: ${why}; TimeoutStopSec assumes a cancel grace of 30s\n`);
+        return DEFAULT_APP_CANCEL_GRACE_MS;
+    }
+    return Math.max(DEFAULT_APP_CANCEL_GRACE_MS, ...Object.values(loaded.config.workflows).map((w) => w.execute.cancelGraceMs));
+}
+/** Resolve symlinks of existing paths (so `/srv/x -> /etc` cannot bypass the system-path check). */
+function realOrResolved(p) {
+    const abs = path.resolve(p);
+    try {
+        return realpathSync(abs);
+    }
+    catch {
+        return abs;
+    }
+}
+/** Warning if a worker's cancel grace cannot take effect within the cancel timeout. */
+export function cancelGraceWarning(maxCancelGraceMs, cancelTimeoutMs) {
+    if (maxCancelGraceMs < cancelTimeoutMs)
+        return null;
+    return (`the largest execute.cancel_grace (${formatCliDuration(maxCancelGraceMs)}) is not smaller than the cancel timeout ` +
+        `(${formatCliDuration(cancelTimeoutMs)}): on shutdown the orchestrator may stop before workers are SIGKILLed; ` +
+        'raise --cancel-timeout or lower cancel_grace');
+}
+/** Collect and validate the unit options from the CLI flags. */
+export async function unitOptionsFromCli(opts, deps, io) {
+    const dryRun = opts.dryRun === true;
+    if (!opts.configDir || !opts.dataDir) {
+        throw new ServiceError('service_invalid_option', 'service install: --config-dir and --data-dir are required (absolute paths recommended, e.g. /etc/adispatchd and /var/lib/adispatchd)');
+    }
+    const unitName = opts.name ?? DEFAULT_UNIT_NAME;
+    const user = opts.user ?? DEFAULT_SERVICE_USER;
+    // Check the paths as given and with symlinks resolved (e.g. /srv/x -> /etc, or /var -> /private/var on macOS).
+    assertSafeServicePaths({ configDir: path.resolve(opts.configDir), dataDir: path.resolve(opts.dataDir) });
+    const configDir = realOrResolved(opts.configDir);
+    const dataDir = realOrResolved(opts.dataDir);
+    assertSafeServicePaths({ configDir, dataDir });
+    const envFile = opts.envFile === 'none' ? null : path.resolve(opts.envFile ?? `/etc/default/${unitName}`);
+    return {
+        unitName,
+        user,
+        group: opts.group ?? user,
+        nodePath: path.resolve(opts.node ?? deps.execPath ?? process.execPath),
+        entryPath: path.resolve(opts.entry ?? deps.entryPath ?? defaultEntryPath()),
+        configDir,
+        dataDir,
+        envFile,
+        drainTimeoutMs: duration('drain-timeout', opts.drainTimeout, '10m'),
+        cancelTimeoutMs: duration('cancel-timeout', opts.cancelTimeout, '2m'),
+        maxCancelGraceMs: await maxCancelGrace(configDir, dataDir, io, dryRun),
+    };
+}
+function pathWarnings(unit) {
+    const warnings = [];
+    for (const [label, p] of [
+        ['node', unit.nodePath],
+        ['package', unit.entryPath],
+    ]) {
+        if (/^\/(root|home|Users)\//.test(p)) {
+            warnings.push(`${label} path ${p} lies in a home directory (nvm/user install?) – the service user "${unit.user}" may not be able to read it; ` +
+                'prefer a system-wide node and a global install of a fixed version (npm install -g adispatchd@<version>) or pass --node/--entry');
+        }
+    }
+    return warnings;
+}
+async function userExists(runner, user) {
+    return (await runner.exec(['id', '-u', user])).code === 0;
+}
+/** `service install`. */
+export function createServiceInstallHandler(io, deps = {}) {
+    return async (opts) => {
+        const platform = deps.platform ?? process.platform;
+        const runner = deps.runner ?? systemRunner;
+        const linux = platform === 'linux';
+        if (!opts.dryRun && !linux)
+            return unsupported(io, platform, 'install');
+        let unit;
+        let content;
+        try {
+            unit = await unitOptionsFromCli(opts, deps, io);
+            content = renderSystemdUnit(unit);
+        }
+        catch (err) {
+            io.stderr(`service install: ${errorMessage(err)}\n`);
+            return 2;
+        }
+        const warnings = pathWarnings(unit);
+        const graceWarning = cancelGraceWarning(unit.maxCancelGraceMs, unit.cancelTimeoutMs);
+        if (graceWarning)
+            warnings.push(graceWarning);
+        const unitDir = path.resolve(opts.unitDir ?? DEFAULT_UNIT_DIR);
+        // Probing the user is read-only (`id -u`); on non-Linux dry runs it is skipped.
+        const exists = linux ? await userExists(runner, unit.user) : true;
+        const input = {
+            unit,
+            unitDir,
+            createUser: opts.createUser === true,
+            userExists: exists,
+            envFileExists: unit.envFile !== null && runner.exists(unit.envFile),
+            startNow: opts.now === true,
+            dryRun: opts.dryRun === true,
+        };
+        let plan;
+        try {
+            plan = planInstall(input);
+        }
+        catch (err) {
+            io.stderr(`service install: ${errorMessage(err)}\n`);
+            return 1;
+        }
+        if (opts.dryRun) {
+            io.stdout(`# ${unitFilePath(unitDir, unit.unitName)}\n${content}\n`);
+            if (!linux)
+                io.stdout(`# note: this is ${platform}; the unit is only usable on Linux with systemd\n`);
+            io.stdout(`# planned steps (dry run, nothing was changed):\n${formatPlan(plan)}`);
+            for (const n of [...warnings, ...plan.notes])
+                io.stdout(`# note: ${n}\n`);
+            return 0;
+        }
+        const euid = deps.euid ?? (() => process.geteuid?.() ?? -1);
+        if (euid() !== 0) {
+            io.stderr('service install: must run as root (e.g. sudo "$(command -v node)" "$(command -v adispatch)" service install ...)\n');
+            return 1;
+        }
+        for (const w of warnings)
+            io.stderr(`warning: ${w}\n`);
+        if ((await runner.exec(['systemctl', '--version'])).code !== 0) {
+            io.stderr('service install: systemctl not found – is this a systemd system?\n');
+            return 1;
+        }
+        const result = await executePlan(plan, runner, io.stdout);
+        if (!result.ok) {
+            io.stderr(`service install failed at "${result.failedStep?.description}": ${result.error}\n`);
+            return 1;
+        }
+        for (const n of plan.notes)
+            io.stdout(`note: ${n}\n`);
+        io.stdout(`service ${unit.unitName} installed (${unitFilePath(unitDir, unit.unitName)})\n`);
+        return 0;
+    };
+}
+/** `service uninstall`. */
+export function createServiceUninstallHandler(io, deps = {}) {
+    return async (opts) => {
+        const platform = deps.platform ?? process.platform;
+        const plan = planUninstall({ unitName: opts.name ?? DEFAULT_UNIT_NAME, unitDir: path.resolve(opts.unitDir ?? DEFAULT_UNIT_DIR) });
+        if (opts.dryRun) {
+            io.stdout(`# planned steps (dry run, nothing was changed):\n${formatPlan(plan)}`);
+            for (const n of plan.notes)
+                io.stdout(`# note: ${n}\n`);
+            return 0;
+        }
+        if (platform !== 'linux')
+            return unsupported(io, platform, 'uninstall');
+        const euid = deps.euid ?? (() => process.geteuid?.() ?? -1);
+        if (euid() !== 0) {
+            io.stderr('service uninstall: must run as root\n');
+            return 1;
+        }
+        const result = await executePlan(plan, deps.runner ?? systemRunner, io.stdout);
+        if (!result.ok) {
+            io.stderr(`service uninstall failed at "${result.failedStep?.description}": ${result.error}\n`);
+            return 1;
+        }
+        for (const n of plan.notes)
+            io.stdout(`note: ${n}\n`);
+        return 0;
+    };
+}
+/** `service status`: `systemctl status <unit>` (read-only). */
+export function createServiceStatusHandler(io, deps = {}) {
+    return async (opts) => {
+        const platform = deps.platform ?? process.platform;
+        if (platform !== 'linux')
+            return unsupported(io, platform, 'status');
+        const unitName = opts.name ?? DEFAULT_UNIT_NAME;
+        const r = await (deps.runner ?? systemRunner).exec(['systemctl', 'status', '--no-pager', '--lines', '20', `${unitName}.service`]);
+        if (r.stdout)
+            io.stdout(r.stdout);
+        if (r.stderr)
+            io.stderr(r.stderr);
+        // systemctl status: 0 = active, 3 = inactive, 4 = unknown unit.
+        if (r.code === 4)
+            io.stderr(`unit ${unitName}.service is not installed (adispatch service install ...)\n`);
+        return r.code === 0 ? 0 : 1;
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/cli/service.js.map

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

package/dist/cli/start.d.ts

@@ -0,0 +1,22 @@
+import { type App, type AppOptions, type SignalTarget } from '../app.js';
+import type { CliIo, StartCliOptions } from './program.js';
+/** Parse the `start` flags (throws on invalid values). */
+export declare function parseStartFlags(opts: StartCliOptions): {
+    drainTimeoutMs?: number;
+    cancelTimeoutMs?: number;
+    host?: string;
+    port?: number;
+};
+/** Injectable dependencies (tests). */
+export interface StartDeps {
+    /** Extra app options (tests: Fake-GitHub fetch, env, port 0). */
+    appOptions?: Partial<AppOptions>;
+    /** Signal source (default `process`). */
+    signals?: SignalTarget;
+    /** Hard exit used as safety net if the event loop does not drain after stop (default `process.exit`). */
+    exit?: (code: number) => void;
+    /** Called once the app listens (tests). */
+    onStarted?: (app: App) => void;
+}
+/** Create the `start` handler. */
+export declare function createStartHandler(io: Pick<CliIo, 'stdout' | 'stderr'>, deps?: StartDeps): (opts: StartCliOptions) => Promise<number>;

package/dist/cli/start.js

@@ -0,0 +1,133 @@
+/**
+ * `start --config-dir <dir> [--data-dir <dir>] [--drain-timeout 10m]
+ * [--cancel-timeout 2m] [--host h] [--port p]` (Spec §4, §14): starts the
+ * orchestrator in the foreground, prints the URL, warns on non-loopback
+ * binds, handles SIGTERM/SIGINT (drain with `--drain-timeout`, then
+ * cancel-all with `--cancel-timeout`; a second signal cancels immediately)
+ * and exits with 0 after an orderly shutdown (also after an API drain /
+ * cancel-all), 2 on usage errors, {@link EXIT_CONFIG} (78, EX_CONFIG) on
+ * configuration/start errors a restart cannot fix (invalid configuration,
+ * instance lock held, database migration error; the systemd unit sets
+ * `RestartPreventExitStatus=78`), 1 on other startup errors or a fatal error.
+ */
+import path from 'node:path';
+import { errorMessage, formatDuration, isOrchestratorError, parseDuration } from '../core/index.js';
+import { ConfigLoadError, formatConfigIssue } from '../config/index.js';
+import { DEFAULT_CANCEL_TIMEOUT_MS, DEFAULT_DRAIN_TIMEOUT_MS, createApp, installSignalHandlers, isLoopback, } from '../app.js';
+import { resolveUiDir } from '../ui/index.js';
+import { EXIT_CONFIG } from '../service/index.js';
+import { cancelGraceWarning } from './service.js';
+function durationFlag(name, value) {
+    if (value === undefined)
+        return undefined;
+    try {
+        return parseDuration(value);
+    }
+    catch (err) {
+        throw new Error(`invalid --${name} "${value}": ${errorMessage(err)}`);
+    }
+}
+/** Parse the `start` flags (throws on invalid values). */
+export function parseStartFlags(opts) {
+    const out = {};
+    const drain = durationFlag('drain-timeout', opts.drainTimeout);
+    const cancel = durationFlag('cancel-timeout', opts.cancelTimeout);
+    if (drain !== undefined)
+        out.drainTimeoutMs = drain;
+    if (cancel !== undefined)
+        out.cancelTimeoutMs = cancel;
+    if (opts.host !== undefined)
+        out.host = opts.host;
+    if (opts.port !== undefined) {
+        const port = Number(opts.port);
+        if (!Number.isInteger(port) || port < 0 || port > 65535)
+            throw new Error(`invalid --port "${opts.port}"`);
+        out.port = port;
+    }
+    return out;
+}
+/** Create the `start` handler. */
+export function createStartHandler(io, deps = {}) {
+    return async (opts) => {
+        if (!opts.configDir) {
+            io.stderr('start: --config-dir is required\n');
+            return 2;
+        }
+        let flags;
+        try {
+            flags = parseStartFlags(opts);
+        }
+        catch (err) {
+            io.stderr(`start: ${errorMessage(err)}\n`);
+            return 2;
+        }
+        const configDir = path.resolve(opts.configDir);
+        const dataDir = path.resolve(opts.dataDir ?? 'data');
+        // Static web UI (WI-11): built assets from `dist/ui/public`; the API also runs without them.
+        const uiDir = deps.appOptions && 'uiDir' in deps.appOptions ? deps.appOptions.uiDir : (resolveUiDir() ?? undefined);
+        const appOptions = {
+            configDir,
+            dataDir,
+            ...flags,
+            ...(deps.appOptions ?? {}),
+            ...(uiDir ? { uiDir } : {}),
+        };
+        let app;
+        try {
+            app = await createApp(appOptions);
+        }
+        catch (err) {
+            if (err instanceof ConfigLoadError) {
+                io.stderr(`Configuration in ${configDir} is invalid:\n${err.errors.map((i) => `  ${formatConfigIssue(i)}\n`).join('')}`);
+                return EXIT_CONFIG;
+            }
+            if (isOrchestratorError(err, 'instance_locked') || isOrchestratorError(err, 'migration_error')) {
+                io.stderr(`start: ${err.message}\n`);
+                return EXIT_CONFIG;
+            }
+            io.stderr(`start: ${errorMessage(err)}\n`);
+            return 1;
+        }
+        let url;
+        try {
+            url = await app.start();
+        }
+        catch (err) {
+            io.stderr(`start: cannot listen: ${errorMessage(err)}\n`);
+            await app.shutdown({ mode: 'cancel', cancelTimeoutMs: 0 });
+            return 1;
+        }
+        io.stdout(`adispatchd listening on ${url} (config ${configDir}, data ${dataDir})\n`);
+        io.stdout(`SIGTERM/Ctrl-C: drain up to ${formatDuration(appOptions.drainTimeoutMs ?? DEFAULT_DRAIN_TIMEOUT_MS)}, ` +
+            `then cancel all runs (${formatDuration(appOptions.cancelTimeoutMs ?? DEFAULT_CANCEL_TIMEOUT_MS)}); a second signal cancels immediately\n`);
+        const graceWarning = cancelGraceWarning(Math.max(0, ...Object.values(app.config.current.workflows).map((w) => w.execute.cancelGraceMs)), appOptions.cancelTimeoutMs ?? DEFAULT_CANCEL_TIMEOUT_MS);
+        if (graceWarning)
+            io.stderr(`warning: ${graceWarning}\n`);
+        if (!uiDir)
+            io.stderr('Note: web UI assets not found (run `npm run build`); serving the API only.\n');
+        const host = new URL(url).hostname;
+        if (!isLoopback(host)) {
+            io.stderr(`WARNING: the HTTP API is bound to ${host} without authentication. Only expose it behind an authenticating reverse proxy or VPN ` +
+                '(add its host name to server.allowed_hosts; see docs/operations.md).\n');
+        }
+        const uninstall = installSignalHandlers(app, {
+            ...(deps.signals ? { target: deps.signals } : {}),
+            ...(appOptions.drainTimeoutMs !== undefined ? { drainTimeoutMs: appOptions.drainTimeoutMs } : {}),
+            ...(appOptions.cancelTimeoutMs !== undefined ? { cancelTimeoutMs: appOptions.cancelTimeoutMs } : {}),
+            ...(deps.exit ? { forceExit: deps.exit } : {}),
+        });
+        deps.onStarted?.(app);
+        const result = await app.stopped;
+        uninstall();
+        if (result.error)
+            io.stderr(`adispatchd stopped with error: ${result.error}\n`);
+        else
+            io.stdout('adispatchd stopped\n');
+        // Safety net: if some handle keeps the event loop alive, exit anyway (does not keep the process alive itself).
+        const exit = deps.exit ?? ((code) => process.exit(code));
+        const t = setTimeout(() => exit(result.exitCode), 5_000);
+        t.unref();
+        return result.exitCode;
+    };
+}
+//# sourceMappingURL=start.js.map

package/dist/cli/start.js.map

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

package/dist/cli/workflow-dry-run.d.ts

@@ -0,0 +1,13 @@
+import { type Clock, type FetchLike } from '../core/index.js';
+import type { CliIo, DryRunCliOptions } from './program.js';
+/** Injectable dependencies (tests: Fake-GitHub `fetch`, key env). */
+export interface WorkflowDryRunDeps {
+    /** HTTP client for GitHub (local variant). */
+    fetch?: FetchLike;
+    /** HTTP client for the orchestrator API (default global `fetch`). */
+    apiFetch?: FetchLike;
+    env?: Readonly<Record<string, string | undefined>>;
+    clock?: Clock;
+}
+/** Create the `workflow dry-run` handler. */
+export declare function createWorkflowDryRunHandler(io: Pick<CliIo, 'stdout' | 'stderr'>, deps?: WorkflowDryRunDeps): (workflowId: string, opts: DryRunCliOptions) => Promise<number>;