adispatchd 0.0.0-stage → 0.1.0

package/dist/config/validate.js

@@ -0,0 +1,346 @@
+/**
+ * Semantic validation across files (Spec §19): references, unique IDs,
+ * allowed placeholders per context, contradictions, cron/time zone and
+ * parameter defaults. Runs on the normalized model; paths in issues use the
+ * YAML key names.
+ */
+import path from 'node:path';
+import { Cron } from 'croner';
+import { extractPlaceholders, HOOK_NAMES, isSecretKey, validateTemplate, } from '../core/index.js';
+import { checkFieldName, checkFilterFields } from './field-catalog.js';
+/** Files of the top-level documents. */
+export const CONFIG_FILE = 'config.yaml';
+export const SOURCES_FILE = 'sources.yaml';
+export const IDENTITIES_FILE = 'identities.yaml';
+/** Env variable prefix reserved for the orchestrator (Spec §9.1). */
+export const RESERVED_ENV_PREFIX = 'ADISPATCH_';
+/** True if `tz` is a valid IANA time zone for this runtime. */
+export function isValidTimeZone(tz) {
+    try {
+        new Intl.DateTimeFormat('en-US', { timeZone: tz });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Validate a cron expression (croner syntax); returns an error message or `undefined`. */
+export function cronError(expression, timezone) {
+    try {
+        const job = new Cron(expression, { paused: true, ...(timezone ? { timezone } : {}) });
+        const next = job.nextRun();
+        job.stop();
+        if (next === null)
+            return `Cron expression "${expression}" never fires`;
+        return undefined;
+    }
+    catch (err) {
+        return `Invalid cron expression "${expression}": ${err.message}`;
+    }
+}
+/** Run all semantic checks and add problems to `issues`. */
+export function validateSemantics(input, issues) {
+    validateGlobal(input.global, issues);
+    validateSources(input, issues);
+    const seenWorkflows = new Map();
+    for (const entry of input.workflows) {
+        const { workflow } = entry;
+        const previous = seenWorkflows.get(workflow.id);
+        if (previous !== undefined) {
+            issues.error(workflow.file, ['id'], `Duplicate workflow ID "${workflow.id}" (already defined in ${previous})`);
+            continue;
+        }
+        seenWorkflows.set(workflow.id, workflow.file);
+        validateWorkflow(entry, input, issues);
+    }
+    const seenViews = new Map();
+    for (const entry of input.views) {
+        const previous = seenViews.get(entry.view.id);
+        if (previous !== undefined) {
+            issues.error(entry.view.file, ['id'], `Duplicate view ID "${entry.view.id}" (already defined in ${previous})`);
+            continue;
+        }
+        seenViews.set(entry.view.id, entry.view.file);
+        validateView(entry, input, issues);
+    }
+}
+function validateGlobal(global, issues) {
+    const ids = new Set();
+    global.notifications.channels.forEach((channel, i) => {
+        const at = ['notifications', 'channels', i];
+        if (ids.has(channel.id))
+            issues.error(CONFIG_FILE, [...at, 'id'], `Duplicate channel ID "${channel.id}"`);
+        ids.add(channel.id);
+        if ((channel.url === null) === (channel.urlEnv === null)) {
+            issues.error(CONFIG_FILE, at, 'Webhook channel needs exactly one of "url" or "url_env"');
+        }
+        else if (channel.url !== null && !isHttpUrl(channel.url)) {
+            // Never echo the URL: it may contain a token (Spec §18).
+            issues.error(CONFIG_FILE, [...at, 'url'], 'Webhook "url" must be an absolute http(s) URL');
+        }
+    });
+}
+function isHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === 'https:' || url.protocol === 'http:';
+    }
+    catch {
+        return false;
+    }
+}
+function validateSources(input, issues) {
+    for (const source of Object.values(input.sources)) {
+        if (!input.identities[source.identity]) {
+            issues.error(SOURCES_FILE, ['sources', source.id, 'identity'], `Unknown identity "${source.identity}"`);
+        }
+    }
+}
+function checkIdentity(id, input, issues, file, at) {
+    if (id && !input.identities[id])
+        issues.error(file, at, `Unknown identity "${id}"`);
+}
+function checkTemplate(template, mode, scope, issues, file, at) {
+    for (const issue of validateTemplate(template, { mode, scope })) {
+        issues.error(file, at, issue.message);
+    }
+}
+function checkEnvNames(names, issues, file, at) {
+    for (const name of names) {
+        if (name.toUpperCase().startsWith(RESERVED_ENV_PREFIX)) {
+            issues.error(file, [...at, name], `Environment variables with prefix "${RESERVED_ENV_PREFIX}" are reserved`);
+        }
+    }
+}
+function checkLiteralSecrets(env, issues, file, at) {
+    for (const [name, value] of Object.entries(env)) {
+        if (value !== '' && isSecretKey(name)) {
+            issues.warning(file, [...at, name], 'Looks like a secret stored literally in YAML; use "secrets" with an identity or an environment of the service instead');
+        }
+    }
+}
+function validateWorkflow(entry, input, issues) {
+    const { workflow: wf } = entry;
+    const file = wf.file;
+    const stem = path.basename(file, path.extname(file));
+    if (stem !== wf.id) {
+        issues.warning(file, ['id'], `Workflow ID "${wf.id}" differs from file name "${path.basename(file)}"`);
+    }
+    checkIdentity(wf.identity, input, issues, file, ['identity']);
+    const isSource = wf.trigger.type === 'source';
+    if (wf.trigger.type === 'source' && !input.sources[wf.trigger.source]) {
+        issues.error(file, ['trigger', 'source'], `Unknown source "${wf.trigger.source}"`);
+    }
+    if (wf.trigger.type === 'schedule') {
+        const tzOk = isValidTimeZone(wf.trigger.timezone);
+        if (!tzOk)
+            issues.error(file, ['trigger', 'timezone'], `Invalid time zone "${wf.trigger.timezone}"`);
+        const err = cronError(wf.trigger.cron, tzOk ? wf.trigger.timezone : undefined);
+        if (err)
+            issues.error(file, ['trigger', 'cron'], err);
+    }
+    if (wf.trigger.type === 'source') {
+        const source = input.sources[wf.trigger.source];
+        if (source) {
+            const ctx = { sourceType: source.type, view: false };
+            if (wf.filter)
+                addFieldIssues(checkFilterFields(wf.filter, ctx, { listing: true }), issues, file, ['filter']);
+            wf.itemPriority?.rules.forEach((rule, i) => addFieldIssues(checkFilterFields(rule.when, ctx, { listing: false }), issues, file, ['item_priority', 'rules', i, 'when']));
+        }
+    }
+    if (!isSource) {
+        const why = `is only allowed for workflows with a source trigger (trigger is "${wf.trigger.type}")`;
+        if (wf.filter)
+            issues.error(file, ['filter'], `"filter" ${why}`);
+        if (wf.shellFilter)
+            issues.error(file, ['shell_filter'], `"shell_filter" ${why}`);
+        if (wf.itemPriority)
+            issues.error(file, ['item_priority'], `"item_priority" ${why}`);
+        if (wf.conditions.item.length > 0)
+            issues.error(file, ['conditions', 'item'], `Item conditions ${why}`);
+    }
+    // Parameters
+    const automatic = wf.trigger.type !== 'manual';
+    for (const [name, raw] of Object.entries(entry.rawParameters)) {
+        validateParameter(name, raw, automatic, issues, file);
+    }
+    const parameterNames = Object.keys(wf.parameters);
+    // Conditions: evaluated before a run exists, without manual parameters.
+    wf.conditions.workflow.forEach((c, i) => c.args.forEach((arg, j) => checkTemplate(arg, 'text', {}, issues, file, ['conditions', 'workflow', i, 'args', j])));
+    wf.conditions.item.forEach((c, i) => c.args.forEach((arg, j) => checkTemplate(arg, 'text', { source: true }, issues, file, ['conditions', 'item', i, 'args', j])));
+    wf.conditions.item.forEach((c, i) => {
+        if (c.cacheMs !== null) {
+            issues.error(file, ['conditions', 'item', i, 'cache'], '"cache" is only supported for workflow conditions');
+        }
+    });
+    // Execute
+    const exec = wf.execute;
+    const wdIssues = issues.items.length;
+    checkTemplate(exec.workingDirectory, 'path', { run: true, source: isSource, parameters: parameterNames }, issues, file, [
+        'execute',
+        'working_directory',
+    ]);
+    // In path mode a parameter must always have a value: required or with default.
+    const wdPlaceholders = safePlaceholders(exec.workingDirectory);
+    for (const [name, def] of Object.entries(wf.parameters)) {
+        if (!def.required && def.default === null && wdPlaceholders.includes(`parameters.${name}`)) {
+            issues.error(file, ['execute', 'working_directory'], `Parameter "${name}" is optional without default and cannot be used in a path`);
+        }
+    }
+    if (issues.items.length === wdIssues &&
+        !exec.workingDirectory.startsWith('/') &&
+        !exec.workingDirectory.startsWith('{workspace.base_dir}')) {
+        issues.error(file, ['execute', 'working_directory'], 'Must be absolute: start with "/" or "{workspace.base_dir}"');
+    }
+    const runScope = { run: true, workspace: true, source: isSource, parameters: parameterNames };
+    exec.args.forEach((arg, i) => checkTemplate(arg, 'text', runScope, issues, file, ['execute', 'args', i]));
+    for (const [name, value] of Object.entries(exec.env)) {
+        checkTemplate(value, 'text', runScope, issues, file, ['execute', 'env', name]);
+    }
+    checkEnvNames(Object.keys(exec.env), issues, file, ['execute', 'env']);
+    checkEnvNames(Object.keys(exec.secrets), issues, file, ['execute', 'secrets']);
+    checkLiteralSecrets(exec.env, issues, file, ['execute', 'env']);
+    for (const [name, ref] of Object.entries(exec.secrets)) {
+        checkIdentity(ref.identity, input, issues, file, ['execute', 'secrets', name, 'identity']);
+        if (name in exec.env) {
+            issues.error(file, ['execute', 'secrets', name], `"${name}" is defined both in "env" and "secrets"`);
+        }
+    }
+    const { maxDurationMs, idleTimeoutMs } = exec.timeout;
+    if (maxDurationMs !== null && idleTimeoutMs !== null && idleTimeoutMs > maxDurationMs) {
+        issues.warning(file, ['execute', 'timeout', 'idle_timeout'], '"idle_timeout" is longer than "max_duration"');
+    }
+    // Hooks
+    const actionIds = new Map();
+    for (const hook of HOOK_NAMES) {
+        wf.hooks[hook].forEach((action, i) => {
+            const at = [hook, i];
+            const where = `${hook}[${i}]`;
+            const previous = actionIds.get(action.id);
+            if (previous !== undefined) {
+                issues.error(file, [...at, 'id'], `Duplicate action ID "${action.id}" (also used at ${previous})`);
+            }
+            actionIds.set(action.id, where);
+            validateAction(action, hook, at, isSource, parameterNames, input, issues, file);
+        });
+    }
+}
+function safePlaceholders(template) {
+    try {
+        return extractPlaceholders(template);
+    }
+    catch {
+        return []; // syntax errors are reported by checkTemplate
+    }
+}
+function validateAction(action, hook, at, isSource, parameterNames, input, issues, file) {
+    const scope = {
+        run: true,
+        workspace: true,
+        source: isSource,
+        result: hook !== 'on_start',
+        parameters: parameterNames,
+    };
+    if ((action.type === 'source.update' || action.type === 'source.comment') && !isSource) {
+        issues.error(file, [...at, 'type'], `"${action.type}" needs a source item; the workflow has no source trigger`);
+    }
+    switch (action.type) {
+        case 'source.update':
+            if (action.labels.add.length === 0 && action.labels.remove.length === 0) {
+                issues.error(file, [...at, 'labels'], '"source.update" must add or remove at least one label');
+            }
+            // Labels compare case-insensitively (GitHub, adapter): `Ready` and `ready` are the same label.
+            for (const label of action.labels.add) {
+                if (action.labels.remove.some((r) => r.toLowerCase() === label.toLowerCase())) {
+                    issues.error(file, [...at, 'labels'], `Label "${label}" is both added and removed`);
+                }
+            }
+            break;
+        case 'source.comment':
+            checkIdentity(action.identity, input, issues, file, [...at, 'identity']);
+            checkTemplate(action.message, 'text', scope, issues, file, [...at, 'message']);
+            break;
+        case 'shell':
+            action.args.forEach((arg, j) => checkTemplate(arg, 'text', scope, issues, file, [...at, 'args', j]));
+            for (const [name, value] of Object.entries(action.env)) {
+                checkTemplate(value, 'text', scope, issues, file, [...at, 'env', name]);
+            }
+            checkEnvNames(Object.keys(action.env), issues, file, [...at, 'env']);
+            checkLiteralSecrets(action.env, issues, file, [...at, 'env']);
+            break;
+    }
+}
+function validateParameter(name, raw, automatic, issues, file) {
+    const at = ['parameters', name];
+    if (raw.type === 'enum' && new Set(raw.values).size !== raw.values.length) {
+        issues.error(file, [...at, 'values'], 'Enum values must be unique');
+    }
+    if (raw.default !== undefined) {
+        const def = raw.default;
+        let ok;
+        switch (raw.type) {
+            case 'string':
+                ok = typeof def === 'string';
+                break;
+            case 'number':
+                ok = typeof def === 'number' && Number.isFinite(def);
+                break;
+            case 'boolean':
+                ok = typeof def === 'boolean';
+                break;
+            case 'enum':
+                ok = typeof def === 'string' && raw.values.includes(def);
+                break;
+        }
+        if (!ok) {
+            const expected = raw.type === 'enum' ? `one of ${raw.values.map((v) => `"${v}"`).join(', ')}` : `a ${raw.type}`;
+            issues.error(file, [...at, 'default'], `Default does not match parameter type: expected ${expected}`);
+        }
+    }
+    else if (raw.required && automatic) {
+        issues.error(file, [...at, 'required'], 'Required parameter without default in an automatically triggered workflow: automatic runs could never supply it');
+    }
+}
+function validateView(entry, input, issues) {
+    const { view } = entry;
+    const file = view.file;
+    if (entry.hasShellFilter) {
+        issues.error(file, ['shell_filter'], 'Views do not support "shell_filter"; views never run shell scripts (Spec §17)');
+    }
+    const types = new Set();
+    view.sources.forEach((id, i) => {
+        const source = input.sources[id];
+        if (!source)
+            issues.error(file, ['sources', i], `Unknown source "${id}"`);
+        else
+            types.add(source.type);
+    });
+    if (new Set(view.sources).size !== view.sources.length) {
+        issues.error(file, ['sources'], 'Sources of a view must be unique');
+    }
+    if (types.size > 1) {
+        issues.error(file, ['sources'], `All sources of a view must have the same adapter type (found: ${[...types].join(', ')})`);
+    }
+    if (types.size === 1) {
+        const ctx = { sourceType: [...types][0], view: true };
+        if (view.filter)
+            addFieldIssues(checkFilterFields(view.filter, ctx, { listing: true }), issues, file, ['filter']);
+        const checkName = (field, at) => {
+            const message = checkFieldName(field, ctx);
+            if (message)
+                issues.error(file, at, message);
+        };
+        view.fields.forEach((f, i) => {
+            checkName(f.field, ['fields', i, 'field']);
+            if (f.link)
+                checkName(f.link, ['fields', i, 'link']);
+        });
+        if (view.sort)
+            checkName(view.sort.field, ['sort', 'field']);
+    }
+}
+function addFieldIssues(found, issues, file, at) {
+    for (const issue of found)
+        issues.error(file, [...at, ...issue.path], issue.message);
+}
+//# sourceMappingURL=validate.js.map

package/dist/config/validate.js.map

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

package/dist/core/clock.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Time abstractions. All logic that must be testable reads time through a
+ * {@link Clock} and schedules delays through {@link Timers}, never via
+ * `Date.now()` / global `setTimeout` directly.
+ */
+/** Source of the current wall-clock time. */
+export interface Clock {
+    /** Current time. Implementations must return a fresh `Date` instance. */
+    now(): Date;
+}
+/** Opaque handle returned by {@link Timers.setTimeout}. */
+export type TimerHandle = object;
+/** Minimal timer scheduling abstraction (injectable for tests). */
+export interface Timers {
+    /** Schedule `callback` once after `ms` milliseconds. */
+    setTimeout(callback: () => void, ms: number): TimerHandle;
+    /** Cancel a timer; unknown or already-fired handles are ignored. */
+    clearTimeout(handle: TimerHandle): void;
+}
+/** Clock backed by the real system time. */
+export declare const systemClock: Clock;
+/** Timers backed by the Node.js event loop. */
+export declare const systemTimers: Timers;
+/**
+ * Resolve after `ms` milliseconds using the given timers. Rejects with the
+ * signal's reason when `signal` is aborted before the delay elapses.
+ */
+export declare function sleep(timers: Timers, ms: number, signal?: AbortSignal): Promise<void>;
+/**
+ * Deterministic clock + timers for tests. Time only moves through
+ * {@link FakeClock.advance} / {@link FakeClock.set}; due timers fire in
+ * chronological order while advancing.
+ */
+export declare class FakeClock implements Clock, Timers {
+    private current;
+    private nextId;
+    private timers;
+    /** @param start initial time (Date, epoch ms or ISO string); default 2026-01-01T00:00:00Z */
+    constructor(start?: Date | number | string);
+    now(): Date;
+    /** Current time in epoch milliseconds. */
+    nowMs(): number;
+    setTimeout(callback: () => void, ms: number): TimerHandle;
+    clearTimeout(handle: TimerHandle): void;
+    /** Number of timers that have not fired yet. */
+    pendingTimers(): number;
+    /** Move time forward by `ms`, firing every timer that becomes due (in order). */
+    advance(ms: number): void;
+    /**
+     * Like {@link advance}, but yields to the microtask queue after each fired
+     * timer so that promise continuations (e.g. after {@link sleep}) can run.
+     */
+    advanceAsync(ms: number): Promise<void>;
+    /** Jump to an absolute time. Moving backwards does not fire timers. */
+    set(time: Date | number | string): void;
+    private runUntil;
+    private nextDue;
+    private fire;
+}

package/dist/core/clock.js

@@ -0,0 +1,133 @@
+/**
+ * Time abstractions. All logic that must be testable reads time through a
+ * {@link Clock} and schedules delays through {@link Timers}, never via
+ * `Date.now()` / global `setTimeout` directly.
+ */
+/** Clock backed by the real system time. */
+export const systemClock = {
+    now: () => new Date(),
+};
+/** Timers backed by the Node.js event loop. */
+export const systemTimers = {
+    setTimeout: (callback, ms) => setTimeout(callback, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+/**
+ * Resolve after `ms` milliseconds using the given timers. Rejects with the
+ * signal's reason when `signal` is aborted before the delay elapses.
+ */
+export function sleep(timers, ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new Error('aborted'));
+            return;
+        }
+        const onAbort = () => {
+            timers.clearTimeout(handle);
+            reject(signal?.reason ?? new Error('aborted'));
+        };
+        const handle = timers.setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, Math.max(0, ms));
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/**
+ * Deterministic clock + timers for tests. Time only moves through
+ * {@link FakeClock.advance} / {@link FakeClock.set}; due timers fire in
+ * chronological order while advancing.
+ */
+export class FakeClock {
+    current;
+    nextId = 1;
+    timers = [];
+    /** @param start initial time (Date, epoch ms or ISO string); default 2026-01-01T00:00:00Z */
+    constructor(start = '2026-01-01T00:00:00.000Z') {
+        this.current = new Date(start).getTime();
+        if (Number.isNaN(this.current))
+            throw new TypeError(`Invalid FakeClock start: ${String(start)}`);
+    }
+    now() {
+        return new Date(this.current);
+    }
+    /** Current time in epoch milliseconds. */
+    nowMs() {
+        return this.current;
+    }
+    setTimeout(callback, ms) {
+        const timer = { id: this.nextId++, dueAt: this.current + Math.max(0, ms), callback };
+        this.timers.push(timer);
+        return { id: timer.id };
+    }
+    clearTimeout(handle) {
+        const id = handle.id;
+        this.timers = this.timers.filter((t) => t.id !== id);
+    }
+    /** Number of timers that have not fired yet. */
+    pendingTimers() {
+        return this.timers.length;
+    }
+    /** Move time forward by `ms`, firing every timer that becomes due (in order). */
+    advance(ms) {
+        if (ms < 0)
+            throw new RangeError('FakeClock cannot move backwards via advance()');
+        this.runUntil(this.current + ms);
+    }
+    /**
+     * Like {@link advance}, but yields to the microtask queue after each fired
+     * timer so that promise continuations (e.g. after {@link sleep}) can run.
+     */
+    async advanceAsync(ms) {
+        if (ms < 0)
+            throw new RangeError('FakeClock cannot move backwards via advanceAsync()');
+        const target = this.current + ms;
+        for (;;) {
+            const next = this.nextDue(target);
+            if (!next)
+                break;
+            this.fire(next);
+            await flushMicrotasks();
+        }
+        this.current = target;
+        await flushMicrotasks();
+    }
+    /** Jump to an absolute time. Moving backwards does not fire timers. */
+    set(time) {
+        const target = new Date(time).getTime();
+        if (Number.isNaN(target))
+            throw new TypeError(`Invalid time: ${String(time)}`);
+        if (target >= this.current)
+            this.runUntil(target);
+        else
+            this.current = target;
+    }
+    runUntil(target) {
+        for (;;) {
+            const next = this.nextDue(target);
+            if (!next)
+                break;
+            this.fire(next);
+        }
+        this.current = target;
+    }
+    nextDue(target) {
+        let next;
+        for (const t of this.timers) {
+            if (t.dueAt <= target && (!next || t.dueAt < next.dueAt || (t.dueAt === next.dueAt && t.id < next.id))) {
+                next = t;
+            }
+        }
+        return next;
+    }
+    fire(timer) {
+        this.timers = this.timers.filter((t) => t.id !== timer.id);
+        this.current = Math.max(this.current, timer.dueAt);
+        timer.callback();
+    }
+}
+async function flushMicrotasks() {
+    for (let i = 0; i < 10; i++)
+        await Promise.resolve();
+}
+//# sourceMappingURL=clock.js.map

package/dist/core/clock.js.map

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

package/dist/core/duration.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Parse a duration string into milliseconds.
+ *
+ * Grammar: `<number><unit>` with unit `ms | s | m | h | d`, e.g. `100ms`, `30s`,
+ * `45m`, `6h`, `30d`, `1.5h`. Surrounding whitespace is ignored. Compound forms
+ * (`1h30m`), negative values, missing units and non-integer millisecond
+ * results are rejected with {@link ValidationError}.
+ */
+export declare function parseDuration(input: string): number;
+/** Like {@link parseDuration}, but returns `undefined` instead of throwing. */
+export declare function tryParseDuration(input: string): number | undefined;
+/** Format milliseconds with the largest unit that divides it exactly (e.g. `90000` → `90s`). */
+export declare function formatDuration(ms: number): string;
+/**
+ * Parse a size string into bytes: `<number><unit>` with unit
+ * `B | KB | MB | GB | KiB | MiB | GiB` (case-insensitive), e.g. `100MB` →
+ * 104857600. Throws {@link ValidationError} on missing/unknown units.
+ */
+export declare function parseSize(input: string): number;