adispatchd 0.0.0-stage → 0.1.0

package/dist/cli/control.js

@@ -0,0 +1,186 @@
+/**
+ * Control commands against a running instance over HTTP (Spec §14, §19):
+ * `status`, `pause`, `resume`, `drain`, `cancel-all`, `config reload`.
+ *
+ * Exit codes: 0 = ok, 1 = API error (e.g. reload rejected), 2 = usage error,
+ * 3 = instance not reachable, 4 = `--wait` timed out.
+ */
+import { errorMessage, parseDuration } from '../core/index.js';
+import { formatConfigIssue } from '../config/index.js';
+import { ApiClient, ApiResponseError, ApiUnreachableError, EXIT_UNREACHABLE, resolveBaseUrl } from './http-client.js';
+/** Exit code when `--wait` timed out. */
+export const EXIT_WAIT_TIMEOUT = 4;
+async function client(opts, io, deps) {
+    try {
+        const { url, note } = await resolveBaseUrl(opts);
+        if (note)
+            io.stderr(`note: ${note}\n`);
+        return new ApiClient(url, deps.fetch ? { fetch: deps.fetch } : {});
+    }
+    catch (err) {
+        io.stderr(`${errorMessage(err)}\n`);
+        return 2;
+    }
+}
+function reportError(name, err, io) {
+    if (err instanceof ApiUnreachableError) {
+        io.stderr(`${name}: ${err.message}\n`);
+        return EXIT_UNREACHABLE;
+    }
+    if (err instanceof ApiResponseError) {
+        io.stderr(`${name}: ${err.message} (HTTP ${err.status}, ${err.code})\n`);
+        return 1;
+    }
+    io.stderr(`${name}: ${errorMessage(err)}\n`);
+    return 1;
+}
+/** Text summary of `GET /api/v1/status`. */
+export function formatStatus(s) {
+    const lines = [];
+    const sched = s?.scheduler ?? {};
+    const usage = s?.usage ?? {};
+    const limits = s?.limits ?? {};
+    lines.push(`adispatchd ${s?.version ?? '?'} – started ${s?.startedAt ?? '?'}`);
+    lines.push(`ready:      ${s?.readiness?.ready ? 'yes' : 'no'}`);
+    lines.push(`scheduler:  ${sched.state ?? '?'}${sched.pollingIntervalMs ? ` (polling every ${Math.round(sched.pollingIntervalMs / 1000)}s)` : ''}`);
+    lines.push(`runs:       ${usage.activeRuns ?? 0} active / limit ${limits.maxConcurrent ?? '?'}` +
+        (limits.override !== null && limits.override !== undefined ? ` (override, configured ${limits.configuredMaxConcurrent})` : '') +
+        (usage.recoveryPending ? `, ${usage.recoveryPending} recovery pending` : ''));
+    const byWf = Object.entries((usage.byWorkflow ?? {})).filter(([, v]) => v.active > 0);
+    for (const [id, v] of byWf)
+        lines.push(`  ${id}: ${v.active}/${v.max}`);
+    const counts = s?.counts ?? {};
+    const n = counts.notifications ?? {};
+    lines.push(`blocks:     ${counts.activeBlocks ?? 0} active · failed actions: ${counts.failedActions ?? 0} · notifications failed: ${n.failed ?? 0}, pending: ${n.pending ?? 0}`);
+    if (s?.config)
+        lines.push(`config:     version ${s.config.version}, hash ${String(s.config.hash ?? '').slice(0, 12)}, ${s.config.configDir}`);
+    if (s?.server)
+        lines.push(`server:     ${s.server.host}:${s.server.port}${s.server.loopback ? '' : ' (NOT loopback – must be behind an authenticating proxy)'}`);
+    return `${lines.join('\n')}\n`;
+}
+/** `status`. */
+export function createStatusHandler(io, deps = {}) {
+    return async (opts) => {
+        const api = await client(opts, io, deps);
+        if (typeof api === 'number')
+            return api;
+        try {
+            const { body } = await api.get('/api/v1/status');
+            io.stdout(opts.json ? `${JSON.stringify(body, null, 2)}\n` : formatStatus(body));
+            return 0;
+        }
+        catch (err) {
+            return reportError('status', err, io);
+        }
+    };
+}
+/** `pause` / `resume`. */
+export function createSchedulerHandler(action, io, deps = {}) {
+    return async (opts) => {
+        const api = await client(opts, io, deps);
+        if (typeof api === 'number')
+            return api;
+        try {
+            const { body } = await api.post(`/api/v1/scheduler/${action}`);
+            io.stdout(opts.json
+                ? `${JSON.stringify(body, null, 2)}\n`
+                : `${action === 'pause' ? 'automatic starts paused' : 'automatic starts resumed'} (scheduler: ${body?.scheduler?.state ?? '?'})\n`);
+            return 0;
+        }
+        catch (err) {
+            return reportError(action, err, io);
+        }
+    };
+}
+/** Wait until `/health` is no longer reachable. */
+async function waitForStop(api, opts, io, deps) {
+    const sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const now = deps.now ?? Date.now;
+    let deadline = Number.POSITIVE_INFINITY;
+    if (opts.timeout) {
+        try {
+            deadline = now() + parseDuration(opts.timeout);
+        }
+        catch (err) {
+            io.stderr(`invalid --timeout: ${errorMessage(err)}\n`);
+            return 2;
+        }
+    }
+    io.stdout('waiting for the instance to stop...\n');
+    while (await api.reachable()) {
+        if (now() >= deadline) {
+            io.stderr(`instance still running after ${opts.timeout} (runs are still active; it keeps stopping in the background)\n`);
+            return EXIT_WAIT_TIMEOUT;
+        }
+        await sleep(deps.pollIntervalMs ?? 500);
+    }
+    io.stdout('instance stopped\n');
+    return 0;
+}
+/** `drain` / `cancel-all`. */
+export function createShutdownHandler(mode, io, deps = {}) {
+    return async (opts) => {
+        if (opts.timeout && !opts.wait) {
+            io.stderr('--timeout requires --wait\n');
+            return 2;
+        }
+        const api = await client(opts, io, deps);
+        if (typeof api === 'number')
+            return api;
+        try {
+            const { body } = await api.post(`/api/v1/shutdown/${mode}`, mode === 'cancel-all' && opts.reason ? { reason: opts.reason } : undefined);
+            if (opts.json)
+                io.stdout(`${JSON.stringify(body, null, 2)}\n`);
+            else {
+                const active = Array.isArray(body?.activeRuns) ? body.activeRuns : [];
+                io.stdout(mode === 'drain'
+                    ? `drain started: no new runs; waiting for ${active.length} active run(s), then the instance stops\n`
+                    : `cancel-all started: cancelling ${active.length} active run(s) (on_cancel runs), then the instance stops\n`);
+                for (const id of active)
+                    io.stdout(`  ${id}\n`);
+            }
+        }
+        catch (err) {
+            return reportError(mode, err, io);
+        }
+        return opts.wait ? waitForStop(api, opts, io, deps) : 0;
+    };
+}
+function issueList(issues) {
+    return (issues ?? []).map((i) => `  ${formatConfigIssue(i)}\n`).join('');
+}
+/** `config reload`. */
+export function createConfigReloadHandler(io, deps = {}) {
+    return async (opts) => {
+        const api = await client(opts, io, deps);
+        if (typeof api === 'number')
+            return api;
+        try {
+            const { body } = await api.post('/api/v1/config/reload');
+            if (opts.json) {
+                io.stdout(`${JSON.stringify(body, null, 2)}\n`);
+                return 0;
+            }
+            if (Array.isArray(body?.warnings) && body.warnings.length > 0) {
+                io.stderr(`${body.warnings.length} warning(s):\n${issueList(body.warnings)}`);
+            }
+            io.stdout(body?.changed
+                ? `configuration reloaded: version ${body.version}, hash ${String(body.hash).slice(0, 12)}` +
+                    (Array.isArray(body.resetOverrides) && body.resetOverrides.length > 0 ? `, overrides reset: ${body.resetOverrides.join(', ')}` : '') +
+                    '\n'
+                : `configuration unchanged (version ${body?.version}, hash ${String(body?.hash ?? '').slice(0, 12)})\n`);
+            return 0;
+        }
+        catch (err) {
+            if (err instanceof ApiResponseError && err.code === 'config_invalid') {
+                const details = (err.details ?? {});
+                if (opts.json)
+                    io.stdout(`${JSON.stringify({ error: { code: err.code, message: err.message, details: err.details } }, null, 2)}\n`);
+                io.stderr(`config reload rejected – the active configuration was kept:\n${issueList(details.errors)}`);
+                return 1;
+            }
+            return reportError('config reload', err, io);
+        }
+    };
+}
+//# sourceMappingURL=control.js.map

package/dist/cli/control.js.map

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

package/dist/cli/http-client.d.ts

@@ -0,0 +1,57 @@
+import { type FetchLike } from '../core/index.js';
+/** Default base URL (Spec §5.1 defaults). */
+export declare const DEFAULT_API_URL = "http://127.0.0.1:8787";
+/** CSRF header required by the API for mutating requests. */
+export declare const CSRF_HEADER_NAME = "x-adispatch-request";
+/** Exit code when no instance is reachable. */
+export declare const EXIT_UNREACHABLE = 3;
+/** The instance could not be reached (connection refused, DNS, timeout). */
+export declare class ApiUnreachableError extends Error {
+    readonly baseUrl: string;
+    constructor(baseUrl: string, cause: unknown);
+}
+/** An API error response (`{error: {code, message, details}}`). */
+export declare class ApiResponseError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details: unknown;
+    constructor(status: number, code: string, message: string, details: unknown);
+}
+/** Build a URL for a bind host/port, mapping wildcard binds to loopback. */
+export declare function urlForBind(host: string, port: number): string;
+/**
+ * Resolve the base URL: explicit `--url` → `config.yaml` of `--config-dir`
+ * (host/port are read even if other files are invalid is not guaranteed; on a
+ * load error the default is used and a note returned) → default.
+ */
+export declare function resolveBaseUrl(opts: {
+    url?: string;
+    configDir?: string;
+    dataDir?: string;
+}): Promise<{
+    url: string;
+    note?: string;
+}>;
+/** JSON response of the API. */
+export interface ApiResponse<T = any> {
+    status: number;
+    body: T;
+}
+/** Small API client. */
+export declare class ApiClient {
+    readonly baseUrl: string;
+    private readonly fetchFn;
+    constructor(baseUrl: string, options?: {
+        fetch?: FetchLike;
+        timeoutMs?: number;
+    });
+    private readonly timeoutMs;
+    /** GET a JSON resource; non-2xx → {@link ApiResponseError}. */
+    get<T = any>(p: string): Promise<ApiResponse<T>>;
+    /** POST JSON (CSRF header set); non-2xx → {@link ApiResponseError}. */
+    post<T = any>(p: string, body?: unknown): Promise<ApiResponse<T>>;
+    /** True if `/health` answers (any HTTP status), false if unreachable. */
+    reachable(): Promise<boolean>;
+    request<T>(method: string, p: string, body?: unknown): Promise<ApiResponse<T>>;
+    private raw;
+}

package/dist/cli/http-client.js

@@ -0,0 +1,174 @@
+/**
+ * Minimal HTTP client for the CLI control commands (`status`, `pause`,
+ * `resume`, `drain`, `cancel-all`, `config reload`, `workflow dry-run`)
+ * against a running instance (docs/api.md).
+ *
+ * - Base URL: `--url`, else `server.host`/`server.port` from `config.yaml` of
+ *   `--config-dir`, else `http://127.0.0.1:8787`. Wildcard binds
+ *   (`0.0.0.0`, `::`) are reached via loopback so the `Host` header is on the
+ *   server's allowlist.
+ * - Mutating requests carry the CSRF header `X-Adispatch-Request: 1` and a
+ *   JSON body (never form data); no `Origin` is sent.
+ */
+import { accessSync, constants } from 'node:fs';
+import path from 'node:path';
+import { errorMessage } from '../core/index.js';
+import { loadConfig } from '../config/index.js';
+/** Default base URL (Spec §5.1 defaults). */
+export const DEFAULT_API_URL = 'http://127.0.0.1:8787';
+/** CSRF header required by the API for mutating requests. */
+export const CSRF_HEADER_NAME = 'x-adispatch-request';
+/** Exit code when no instance is reachable. */
+export const EXIT_UNREACHABLE = 3;
+/** The instance could not be reached (connection refused, DNS, timeout). */
+export class ApiUnreachableError extends Error {
+    baseUrl;
+    constructor(baseUrl, cause) {
+        super(`cannot reach the orchestrator at ${baseUrl} (${errorMessage(cause)}) – is it running? Use --url or --config-dir`);
+        this.baseUrl = baseUrl;
+        this.name = 'ApiUnreachableError';
+    }
+}
+/** An API error response (`{error: {code, message, details}}`). */
+export class ApiResponseError extends Error {
+    status;
+    code;
+    details;
+    constructor(status, code, message, details) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.details = details;
+        this.name = 'ApiResponseError';
+    }
+}
+/** Build a URL for a bind host/port, mapping wildcard binds to loopback. */
+export function urlForBind(host, port) {
+    let h = host.replace(/^\[|\]$/g, '');
+    if (h === '0.0.0.0' || h === '')
+        h = '127.0.0.1';
+    else if (h === '::' || h === '::0')
+        h = '::1';
+    return `http://${h.includes(':') ? `[${h}]` : h}:${port}`;
+}
+/**
+ * Resolve the base URL: explicit `--url` → `config.yaml` of `--config-dir`
+ * (host/port are read even if other files are invalid is not guaranteed; on a
+ * load error the default is used and a note returned) → default.
+ */
+export async function resolveBaseUrl(opts) {
+    if (opts.url) {
+        let parsed;
+        try {
+            parsed = new URL(opts.url);
+        }
+        catch {
+            // The raw value may contain credentials – never echo it.
+            throw new Error('invalid --url (expected http(s)://host:port)');
+        }
+        if (parsed.username || parsed.password) {
+            throw new Error('invalid --url: credentials in the URL (user:password@) are not supported – proxy authentication is not implemented; ' +
+                'use the local URL (e.g. http://127.0.0.1:8787) on the host itself');
+        }
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+            throw new Error(`invalid --url "${parsed.origin}" (http/https only)`);
+        return { url: opts.url.replace(/\/+$/, '') };
+    }
+    if (opts.configDir) {
+        const configDir = path.resolve(opts.configDir);
+        const configFile = path.join(configDir, 'config.yaml');
+        try {
+            accessSync(configFile, constants.R_OK);
+        }
+        catch (err) {
+            const code = err.code;
+            if (code === 'EACCES' || code === 'EPERM') {
+                return { url: DEFAULT_API_URL, note: `${configFile} is not readable (permission denied); using ${DEFAULT_API_URL} – pass --url instead of --config-dir` };
+            }
+            // Missing config.yaml: defaults apply (server 127.0.0.1:8787) – fall through to the loader.
+        }
+        const loaded = await loadConfig(configDir, { dataDir: path.resolve(opts.dataDir ?? 'data') });
+        if (loaded.ok) {
+            const { host, port } = loaded.config.global.server;
+            return { url: urlForBind(host, port) };
+        }
+        const unreadable = loaded.errors.some((e) => /EACCES|EPERM|permission denied/i.test(e.message));
+        return {
+            url: DEFAULT_API_URL,
+            note: unreadable
+                ? `configuration in ${configDir} is not readable (permission denied); using ${DEFAULT_API_URL} – pass --url instead of --config-dir`
+                : `configuration in ${configDir} is invalid; using ${DEFAULT_API_URL}`,
+        };
+    }
+    return { url: DEFAULT_API_URL };
+}
+/** Small API client. */
+export class ApiClient {
+    baseUrl;
+    fetchFn;
+    constructor(baseUrl, options = {}) {
+        this.baseUrl = baseUrl;
+        this.fetchFn = options.fetch ?? ((input, init) => fetch(input, init));
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+    }
+    timeoutMs;
+    /** GET a JSON resource; non-2xx → {@link ApiResponseError}. */
+    get(p) {
+        return this.request('GET', p);
+    }
+    /** POST JSON (CSRF header set); non-2xx → {@link ApiResponseError}. */
+    post(p, body) {
+        return this.request('POST', p, body);
+    }
+    /** True if `/health` answers (any HTTP status), false if unreachable. */
+    async reachable() {
+        try {
+            await this.raw('GET', '/health');
+            return true;
+        }
+        catch (err) {
+            if (err instanceof ApiUnreachableError)
+                return false;
+            throw err;
+        }
+    }
+    async request(method, p, body) {
+        const res = await this.raw(method, p, body);
+        const text = await res.text();
+        let json = null;
+        if (text.length > 0) {
+            try {
+                json = JSON.parse(text);
+            }
+            catch {
+                throw new ApiResponseError(res.status, 'invalid_response', `unexpected non-JSON response (HTTP ${res.status}) from ${this.baseUrl}${p}`, null);
+            }
+        }
+        if (res.status < 200 || res.status >= 300) {
+            const e = json?.error;
+            throw new ApiResponseError(res.status, typeof e?.code === 'string' ? e.code : `http_${res.status}`, typeof e?.message === 'string' ? e.message : `HTTP ${res.status}`, e?.details ?? null);
+        }
+        return { status: res.status, body: json };
+    }
+    async raw(method, p, body) {
+        const headers = { accept: 'application/json' };
+        const mutating = method !== 'GET' && method !== 'HEAD';
+        if (mutating)
+            headers[CSRF_HEADER_NAME] = '1';
+        if (body !== undefined)
+            headers['content-type'] = 'application/json';
+        const signal = AbortSignal.timeout(this.timeoutMs);
+        try {
+            return await this.fetchFn(`${this.baseUrl}${p}`, {
+                method,
+                headers,
+                ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+                signal,
+            });
+        }
+        catch (err) {
+            throw new ApiUnreachableError(this.baseUrl, err.cause ?? err);
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/cli/http-client.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Component `cli` – public API (commands of the `adispatch` binary).
+ */
+export { createProgram, EXIT_NOT_IMPLEMENTED } from './program.js';
+export type { CliHandlers, CliIo, ControlCliOptions, DryRunCliOptions, GlobalOptions, InitCliOptions, ServiceCliOptions, ShutdownCliOptions, StartCliOptions, } from './program.js';
+export { processIo } from './program.js';
+export { createConfigValidateHandler, EXIT_CONFIG_INVALID, EXIT_CONFIG_VALID } from './config-validate.js';
+export { createWorkflowDryRunHandler, type WorkflowDryRunDeps } from './workflow-dry-run.js';
+export { createStartHandler, parseStartFlags, type StartDeps } from './start.js';
+export { createInitHandler, initDirectories, type InitResult } from './init.js';
+export { initTemplates, DATA_DIR_LAYOUT, type TemplateFile } from './init-templates.js';
+export { createConfigReloadHandler, createSchedulerHandler, createShutdownHandler, createStatusHandler, formatStatus, EXIT_WAIT_TIMEOUT, type ControlDeps, } from './control.js';
+export { ApiClient, ApiResponseError, ApiUnreachableError, DEFAULT_API_URL, EXIT_UNREACHABLE, resolveBaseUrl, urlForBind, } from './http-client.js';
+export { createServiceInstallHandler, createServiceStatusHandler, createServiceUninstallHandler, defaultEntryPath, unitOptionsFromCli, type ServiceDeps, } from './service.js';

package/dist/cli/index.js

@@ -0,0 +1,14 @@
+/**
+ * Component `cli` – public API (commands of the `adispatch` binary).
+ */
+export { createProgram, EXIT_NOT_IMPLEMENTED } from './program.js';
+export { processIo } from './program.js';
+export { createConfigValidateHandler, EXIT_CONFIG_INVALID, EXIT_CONFIG_VALID } from './config-validate.js';
+export { createWorkflowDryRunHandler } from './workflow-dry-run.js';
+export { createStartHandler, parseStartFlags } from './start.js';
+export { createInitHandler, initDirectories } from './init.js';
+export { initTemplates, DATA_DIR_LAYOUT } from './init-templates.js';
+export { createConfigReloadHandler, createSchedulerHandler, createShutdownHandler, createStatusHandler, formatStatus, EXIT_WAIT_TIMEOUT, } from './control.js';
+export { ApiClient, ApiResponseError, ApiUnreachableError, DEFAULT_API_URL, EXIT_UNREACHABLE, resolveBaseUrl, urlForBind, } from './http-client.js';
+export { createServiceInstallHandler, createServiceStatusHandler, createServiceUninstallHandler, defaultEntryPath, unitOptionsFromCli, } from './service.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAYnE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,EAAE,2BAA2B,EAA2B,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAkB,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAmB,MAAM,WAAW,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACxF,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,GAElB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,6BAA6B,EAC7B,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,cAAc,CAAC"}

package/dist/cli/init-templates.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Files created by `init` (Spec §4): a commented, valid example configuration
+ * that starts without any GitHub credentials. Only the manual `hello`
+ * workflow is enabled; the GitHub coder workflow and the nightly schedule are
+ * disabled examples to copy from. Kept as code (not as package files) so the
+ * installed package needs no asset lookup.
+ */
+/** A file to create, relative to config-dir. */
+export interface TemplateFile {
+    path: string;
+    content: string;
+    /** File mode (scripts are executable). */
+    mode: number;
+}
+/** All files created by `init`, relative to config-dir. */
+export declare function initTemplates(options?: {
+    port?: number;
+}): TemplateFile[];
+/** Directories created in data-dir (Spec §4); the app creates missing ones itself as well. */
+export declare const DATA_DIR_LAYOUT: readonly ['logs', 'runs', 'workspaces', 'backups'];