adispatchd 0.0.0-stage → 0.1.0

package/dist/config/manager.js

@@ -0,0 +1,276 @@
+/**
+ * ConfigManager (Spec §19): holds the active configuration, reloads it
+ * atomically (all-or-nothing) and manages non-persistent runtime overrides.
+ */
+import { errorMessage, noopLogger, OrchestratorError, systemClock, ValidationError, } from '../core/index.js';
+import { loadConfig } from './loader.js';
+import { validateWorkflowParameters } from './parameters.js';
+import { snapshotWorkflow, UnknownWorkflowError } from './snapshot.js';
+/** Workflow settings that can be overridden at runtime. */
+const OVERRIDE_KEYS = ['enabled', 'priority', 'maxConcurrent'];
+/** Thrown by {@link ConfigManager.create} when the initial configuration is invalid. */
+export class ConfigLoadError extends OrchestratorError {
+    errors;
+    warnings;
+    constructor(errors, warnings) {
+        super('config_invalid', `Configuration is invalid (${errors.length} error(s))`, {
+            details: { errors: errors.length },
+        });
+        this.errors = errors;
+        this.warnings = warnings;
+    }
+}
+/**
+ * Holds the active {@link LoadedConfig}. Use {@link ConfigManager.create} to
+ * load the initial configuration.
+ */
+export class ConfigManager {
+    options;
+    active;
+    workflowOverrides = new Map();
+    globalOverrides = {};
+    listeners = new Set();
+    reloadChain = Promise.resolve();
+    clock;
+    logger;
+    loader;
+    /** Use {@link ConfigManager.create} unless you already have a loaded config. */
+    constructor(initial, options) {
+        this.options = options;
+        this.active = initial;
+        this.clock = options.clock ?? systemClock;
+        this.logger = options.logger ?? noopLogger;
+        this.loader = options.loader ?? loadConfig;
+    }
+    /**
+     * Load the configuration and create a manager.
+     * @throws ConfigLoadError if the configuration is invalid.
+     */
+    static async create(options) {
+        const loader = options.loader ?? loadConfig;
+        const result = await loader(options.configDir, {
+            dataDir: options.dataDir,
+            version: 1,
+            clock: options.clock ?? systemClock,
+        });
+        if (!result.ok)
+            throw new ConfigLoadError(result.errors, result.warnings);
+        return new ConfigManager(result.config, options);
+    }
+    /** The active configuration (immutable). */
+    get current() {
+        return this.active;
+    }
+    /**
+     * Reload the whole configuration. Only if loading and validation succeed
+     * completely is the new configuration activated (atomically); otherwise the
+     * active configuration stays untouched and the errors are returned.
+     * Concurrent calls are serialized.
+     */
+    reload() {
+        const next = this.reloadChain.then(() => this.doReload());
+        this.reloadChain = next.catch(() => undefined);
+        return next;
+    }
+    async doReload() {
+        const previous = this.active;
+        let result;
+        try {
+            result = await this.loader(this.options.configDir, {
+                dataDir: this.options.dataDir,
+                version: previous.version + 1,
+                clock: this.clock,
+            });
+        }
+        catch (err) {
+            const message = `Unexpected error while loading configuration: ${errorMessage(err)}`;
+            this.logger.error('config reload failed', { error: message });
+            return { ok: false, errors: [{ severity: 'error', file: '.', path: '', message }], warnings: [] };
+        }
+        if (!result.ok) {
+            this.logger.warn('config reload rejected, keeping active configuration', {
+                errors: result.errors.length,
+                version: previous.version,
+            });
+            return result;
+        }
+        const config = result.config;
+        const diff = diffWorkflows(previous, config);
+        const resetOverrides = [];
+        for (const [id, overrides] of [...this.workflowOverrides]) {
+            const next = Object.hasOwn(config.workflows, id) ? config.workflows[id] : undefined;
+            const before = previous.workflows[id];
+            if (!next || !before) {
+                // Workflow removed: all of its overrides disappear.
+                this.workflowOverrides.delete(id);
+                resetOverrides.push(id);
+                continue;
+            }
+            // Only reset the overrides whose configured value changed (Spec §19 "affected settings").
+            const remaining = { ...overrides };
+            let reset = false;
+            for (const key of OVERRIDE_KEYS) {
+                if (key in remaining && before[key] !== next[key]) {
+                    delete remaining[key];
+                    reset = true;
+                }
+            }
+            if (!reset)
+                continue;
+            resetOverrides.push(id);
+            if (Object.keys(remaining).length === 0)
+                this.workflowOverrides.delete(id);
+            else
+                this.workflowOverrides.set(id, remaining);
+        }
+        resetOverrides.sort();
+        if (this.globalOverrides.maxConcurrent !== undefined &&
+            previous.global.scheduler.maxConcurrent !== config.global.scheduler.maxConcurrent) {
+            this.globalOverrides = {};
+            resetOverrides.push('*');
+        }
+        this.active = config;
+        this.logger.info('config reloaded', { version: config.version, hash: config.hash, ...diff, resetOverrides });
+        this.emit({ kind: 'reload', config, previous, diff, resetOverrides });
+        return {
+            ok: true,
+            config,
+            previous,
+            changed: config.hash !== previous.hash,
+            diff,
+            resetOverrides,
+            warnings: result.warnings,
+        };
+    }
+    /** Register a change listener. */
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    emit(event) {
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(event);
+            }
+            catch (err) {
+                this.logger.error('config change listener failed', { error: errorMessage(err) });
+            }
+        }
+    }
+    requireWorkflow(workflowId) {
+        const wf = Object.hasOwn(this.active.workflows, workflowId) ? this.active.workflows[workflowId] : undefined;
+        if (!wf)
+            throw new UnknownWorkflowError(workflowId);
+        return wf;
+    }
+    /** Workflow with effective values, or `undefined` if unknown. */
+    getWorkflow(workflowId) {
+        const wf = Object.hasOwn(this.active.workflows, workflowId) ? this.active.workflows[workflowId] : undefined;
+        return wf ? this.effective(wf) : undefined;
+    }
+    /** All workflows with effective values, sorted by ID. */
+    listWorkflows() {
+        return Object.keys(this.active.workflows)
+            .sort()
+            .map((id) => this.effective(this.active.workflows[id]));
+    }
+    effective(config) {
+        const overrides = this.workflowOverrides.get(config.id) ?? {};
+        return {
+            config,
+            enabled: overrides.enabled ?? config.enabled,
+            priority: overrides.priority ?? config.priority,
+            maxConcurrent: overrides.maxConcurrent ?? config.maxConcurrent,
+            overrides: { ...overrides },
+        };
+    }
+    /** Effective global limit for automatic starts. */
+    get maxConcurrent() {
+        return this.globalOverrides.maxConcurrent ?? this.active.global.scheduler.maxConcurrent;
+    }
+    /** Current overrides (copies). */
+    getOverrides() {
+        return {
+            global: { ...this.globalOverrides },
+            workflows: Object.fromEntries([...this.workflowOverrides].map(([id, o]) => [id, { ...o }])),
+        };
+    }
+    /**
+     * Merge runtime overrides into the workflow's existing overrides. A key
+     * with value `undefined` removes that override.
+     * @throws UnknownWorkflowError, ValidationError
+     */
+    setWorkflowOverrides(workflowId, overrides) {
+        const wf = this.requireWorkflow(workflowId);
+        validateOverrides(overrides);
+        const merged = { ...(this.workflowOverrides.get(workflowId) ?? {}) };
+        for (const key of OVERRIDE_KEYS) {
+            if (!(key in overrides))
+                continue;
+            const value = overrides[key];
+            if (value === undefined)
+                delete merged[key];
+            else
+                merged[key] = value;
+        }
+        if (Object.keys(merged).length === 0)
+            this.workflowOverrides.delete(workflowId);
+        else
+            this.workflowOverrides.set(workflowId, merged);
+        this.emit({ kind: 'overrides', workflowId });
+        return this.effective(wf);
+    }
+    /** Remove all overrides of a workflow. */
+    clearWorkflowOverrides(workflowId) {
+        if (this.workflowOverrides.delete(workflowId))
+            this.emit({ kind: 'overrides', workflowId });
+    }
+    /**
+     * Override (number) or reset (`undefined`) the global `max_concurrent`.
+     * @throws ValidationError
+     */
+    setGlobalMaxConcurrent(value) {
+        if (value === undefined)
+            this.globalOverrides = {};
+        else {
+            validateOverrides({ maxConcurrent: value });
+            this.globalOverrides = { maxConcurrent: value };
+        }
+        this.emit({ kind: 'overrides', workflowId: null });
+    }
+    /** Snapshot of a workflow of the active configuration (see {@link snapshotWorkflow}). */
+    snapshotWorkflow(workflowId) {
+        return snapshotWorkflow(this.active, workflowId);
+    }
+    /**
+     * Validate manual-start parameters against the workflow's parameter schema.
+     * @throws UnknownWorkflowError
+     */
+    validateParameters(workflowId, input) {
+        return validateWorkflowParameters(this.requireWorkflow(workflowId), input);
+    }
+}
+function validateOverrides(o) {
+    if (o.enabled !== undefined && typeof o.enabled !== 'boolean') {
+        throw new ValidationError('Override "enabled" must be a boolean');
+    }
+    if (o.priority !== undefined && (typeof o.priority !== 'number' || !Number.isFinite(o.priority))) {
+        throw new ValidationError('Override "priority" must be a finite number');
+    }
+    if (o.maxConcurrent !== undefined && (!Number.isSafeInteger(o.maxConcurrent) || o.maxConcurrent < 1)) {
+        throw new ValidationError('Override "maxConcurrent" must be an integer ≥ 1');
+    }
+}
+/** Compare the workflows of two configurations by their hashes. */
+export function diffWorkflows(previous, next) {
+    const before = previous.workflowHashes;
+    const after = next.workflowHashes;
+    return {
+        addedWorkflows: Object.keys(after).filter((id) => !(id in before)).sort(),
+        removedWorkflows: Object.keys(before).filter((id) => !(id in after)).sort(),
+        changedWorkflows: Object.keys(after).filter((id) => id in before && before[id] !== after[id]).sort(),
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

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

package/dist/config/model.d.ts

@@ -0,0 +1,334 @@
+/**
+ * Normalized, validated configuration model (Spec §5, §17, §18).
+ *
+ * Produced by the loader from the YAML files: identifiers are camelCase,
+ * all durations are milliseconds, sizes are bytes, defaults are applied and
+ * `null` marks "not configured". Instances handed out by the loader are
+ * deeply frozen. No secret values are ever part of this model — identities
+ * and notification headers only carry the *names* of environment variables.
+ */
+import type { FilterNode, HookName, NotificationEventType } from '../core/index.js';
+/** HTTP server bind address. */
+export interface ServerConfig {
+    host: string;
+    port: number;
+    /**
+     * Extra accepted `Host`/`Origin` host names (lower case, `name` = any port, `name:port` = exact).
+     * Loopback names are always accepted when bound to loopback (DNS-rebinding protection).
+     */
+    allowedHosts: readonly string[];
+}
+/** Scheduler settings. */
+export interface SchedulerConfig {
+    /** Source polling interval (default 30s). */
+    pollingIntervalMs: number;
+    /** Global limit for automatically started runs (default 5). */
+    maxConcurrent: number;
+}
+/** Workspace cleanup policy after a run finished. */
+export type WorkspaceCleanup = 'always' | 'on_success' | 'never';
+/** Workspace settings. */
+export interface WorkspaceConfig {
+    /** Absolute, normalized base directory (default `${dataDir}/workspaces`). */
+    baseDir: string;
+    cleanup: WorkspaceCleanup;
+}
+/** Retry policy of a lifecycle action. */
+export interface RetryPolicy {
+    /** Total number of attempts (≥ 1). */
+    maxAttempts: number;
+    /** Pause between attempts. */
+    delayMs: number;
+}
+/** Lifecycle defaults. */
+export interface LifecycleConfig {
+    /** Default retry policy of every action (default 3 × 30s). */
+    actionRetry: RetryPolicy;
+}
+/** Retention settings; `null` = `never` (keep forever). */
+export interface RetentionConfig {
+    completedRunsMs: number | null;
+    failedRunsMs: number | null;
+    blockedRunsMs: number | null;
+    maxLogSizePerRunBytes: number;
+    cleanupIntervalMs: number;
+}
+/**
+ * Webhook notification channel (Spec §18). Exactly one of `url` / `urlEnv`
+ * is set. `url` may embed a token (e.g. Slack webhook URLs) and must be
+ * redacted before it is logged or returned by the API ({@link toPublicConfig}).
+ */
+export interface WebhookChannelConfig {
+    id: string;
+    type: 'webhook';
+    url: string | null;
+    /** Name of the environment variable holding the URL. */
+    urlEnv: string | null;
+    /** HTTP header name → name of the environment variable holding its value. */
+    headersEnv: Readonly<Record<string, string>>;
+    /** Events delivered to this channel (default: the global `notifications.on`). */
+    on: readonly NotificationEventType[];
+}
+/** A notification channel. */
+export type NotificationChannelConfig = WebhookChannelConfig;
+/** Central orchestrator notifications. */
+export interface NotificationsConfig {
+    /** Enabled events (default: all {@link NOTIFICATION_EVENT_TYPES}). */
+    on: readonly NotificationEventType[];
+    channels: readonly NotificationChannelConfig[];
+}
+/** Content of `config.yaml`. */
+export interface GlobalConfig {
+    server: ServerConfig;
+    scheduler: SchedulerConfig;
+    workspace: WorkspaceConfig;
+    lifecycle: LifecycleConfig;
+    retention: RetentionConfig;
+    notifications: NotificationsConfig;
+}
+/** GitHub repository source. */
+export interface GithubSourceConfig {
+    id: string;
+    type: 'github';
+    owner: string;
+    repository: string;
+    /** Default identity for reading API calls. */
+    identity: string;
+}
+/** A configured source (V1: only GitHub). */
+export type SourceConfig = GithubSourceConfig;
+/** GitHub App identity. The private key is read from `privateKeyEnv` at runtime. */
+export interface GithubAppIdentityConfig {
+    id: string;
+    type: 'github_app';
+    appId: number;
+    installationId: number;
+    /** Name of the environment variable holding the PEM private key (never the key itself). */
+    privateKeyEnv: string;
+}
+/** A configured identity (V1: only GitHub Apps). */
+export type IdentityConfig = GithubAppIdentityConfig;
+/** Source trigger: polls one source. */
+export interface SourceTriggerConfig {
+    type: 'source';
+    source: string;
+}
+/** Cron trigger. */
+export interface ScheduleTriggerConfig {
+    type: 'schedule';
+    cron: string;
+    /** IANA time zone (default `UTC`). */
+    timezone: string;
+}
+/** Only manually started. */
+export interface ManualTriggerConfig {
+    type: 'manual';
+}
+/** Workflow trigger. */
+export type TriggerConfig = SourceTriggerConfig | ScheduleTriggerConfig | ManualTriggerConfig;
+/** Shell condition (Spec §6): exit 0 = pass, 1 = fail, ≥ 2 = check error. */
+export interface ShellCheckConfig {
+    type: 'shell';
+    command: string;
+    args: readonly string[];
+    /** Default 30s. */
+    timeoutMs: number;
+    /** Result cache TTL; `null` = no caching. */
+    cacheMs: number | null;
+}
+/** Item-level shell filter (workflows only, never views). */
+export interface ShellFilterConfig {
+    command: string;
+    /** Default 30s. */
+    timeoutMs: number;
+}
+/** One item priority rule; the first matching rule wins (Spec §7). */
+export interface ItemPriorityRule {
+    when: FilterNode;
+    value: number;
+}
+/** Item priority configuration. */
+export interface ItemPriorityConfig {
+    rules: readonly ItemPriorityRule[];
+    default: number;
+}
+/** Shared properties of manual-start parameters. */
+interface ParameterBase {
+    required: boolean;
+    description: string | null;
+}
+/** String parameter. */
+export interface StringParameter extends ParameterBase {
+    type: 'string';
+    default: string | null;
+}
+/** Number parameter. */
+export interface NumberParameter extends ParameterBase {
+    type: 'number';
+    default: number | null;
+}
+/** Boolean parameter. */
+export interface BooleanParameter extends ParameterBase {
+    type: 'boolean';
+    default: boolean | null;
+}
+/** Enum parameter. */
+export interface EnumParameter extends ParameterBase {
+    type: 'enum';
+    values: readonly string[];
+    default: string | null;
+}
+/** Declared manual-start parameter (Spec §5.5). */
+export type ParameterDefinition = StringParameter | NumberParameter | BooleanParameter | EnumParameter;
+/** Value of a parameter after validation. */
+export type ParameterValue = string | number | boolean;
+/** Reference to an identity whose short-lived token is exposed as env variable. */
+export interface SecretRef {
+    identity: string;
+}
+/** Main worker execution (Spec §5.4, §8.3, §9). */
+export interface ShellExecuteConfig {
+    type: 'shell';
+    command: string;
+    /** Argument templates (text mode). */
+    args: readonly string[];
+    /** Path template (default `{workspace.base_dir}/{workflow.id}/{run.id}`). */
+    workingDirectory: string;
+    /** Default true. */
+    createDirectory: boolean;
+    /** Env variable → value template (text mode). */
+    env: Readonly<Record<string, string>>;
+    /** Env variable → identity whose token is injected (only in memory). */
+    secrets: Readonly<Record<string, SecretRef>>;
+    timeout: {
+        maxDurationMs: number | null;
+        idleTimeoutMs: number | null;
+    };
+    /** Grace period between SIGTERM and SIGKILL on cancel/timeout (default 30s). */
+    cancelGraceMs: number;
+}
+/** Execution configuration (V1: shell only). */
+export type ExecuteConfig = ShellExecuteConfig;
+/** Shared properties of lifecycle actions. */
+interface ActionBase {
+    /**
+     * Stable action ID within the hook: the configured `id` or `<hook>.<index>`
+     * (e.g. `on_start.0`). Used for the action journal and comment markers.
+     */
+    id: string;
+    continueOnError: boolean;
+    /** Effective retry policy (action override merged over `lifecycle.action_retry`). */
+    retry: RetryPolicy;
+}
+/** `source.update` action (V1: labels). */
+export interface SourceUpdateActionConfig extends ActionBase {
+    type: 'source.update';
+    labels: {
+        add: readonly string[];
+        remove: readonly string[];
+    };
+}
+/**
+ * `source.comment` action. `identity` = action override; callers fall back
+ * to the workflow identity, then the source identity.
+ */
+export interface SourceCommentActionConfig extends ActionBase {
+    type: 'source.comment';
+    /** Text template. */
+    message: string;
+    identity: string | null;
+}
+/** `shell` action. */
+export interface ShellActionConfig extends ActionBase {
+    type: 'shell';
+    command: string;
+    args: readonly string[];
+    /** Default 5m. */
+    timeoutMs: number;
+    env: Readonly<Record<string, string>>;
+}
+/** A lifecycle action. */
+export type LifecycleActionConfig = SourceUpdateActionConfig | SourceCommentActionConfig | ShellActionConfig;
+/** All seven hooks; missing hooks are empty lists. */
+export type HooksConfig = Readonly<Record<HookName, readonly LifecycleActionConfig[]>>;
+/** A validated workflow. */
+export interface WorkflowConfig {
+    id: string;
+    name: string;
+    /** Path of the defining file, relative to the config dir (e.g. `workflows/coder.yaml`). */
+    file: string;
+    enabled: boolean;
+    priority: number;
+    /** Per-workflow limit for automatic starts (default 1). */
+    maxConcurrent: number;
+    /** Default write identity of the workflow; `null` = source identity. */
+    identity: string | null;
+    trigger: TriggerConfig;
+    /** Declarative filter (source workflows only). */
+    filter: FilterNode | null;
+    shellFilter: ShellFilterConfig | null;
+    itemPriority: ItemPriorityConfig | null;
+    conditions: {
+        workflow: readonly ShellCheckConfig[];
+        item: readonly ShellCheckConfig[];
+    };
+    parameters: Readonly<Record<string, ParameterDefinition>>;
+    execute: ExecuteConfig;
+    retry: {
+        maxTechnicalFailures: number;
+    };
+    hooks: HooksConfig;
+}
+/** One view column. */
+export interface ViewFieldConfig {
+    field: string;
+    /** Column label (default: field name). */
+    label: string;
+    /** Field holding the URL this column links to. */
+    link: string | null;
+}
+/** A read-only view. */
+export interface ViewConfig {
+    id: string;
+    title: string;
+    file: string;
+    sources: readonly string[];
+    filter: FilterNode | null;
+    fields: readonly ViewFieldConfig[];
+    sort: {
+        field: string;
+        direction: 'asc' | 'desc';
+    } | null;
+}
+/** Complete, validated, immutable configuration. */
+export interface LoadedConfig {
+    /** Absolute config directory it was loaded from. */
+    configDir: string;
+    /** Monotonic version assigned by the loader caller (ConfigManager: 1, 2, ...). */
+    version: number;
+    /** SHA-256 (hex) over the canonical normalized content. Equal content → equal hash. */
+    hash: string;
+    /** ISO-8601 load time. */
+    loadedAt: string;
+    global: GlobalConfig;
+    sources: Readonly<Record<string, SourceConfig>>;
+    identities: Readonly<Record<string, IdentityConfig>>;
+    workflows: Readonly<Record<string, WorkflowConfig>>;
+    views: Readonly<Record<string, ViewConfig>>;
+    /** SHA-256 per workflow definition (detects changed workflows on reload). */
+    workflowHashes: Readonly<Record<string, string>>;
+}
+/** Severity of a {@link ConfigIssue}. */
+export type ConfigIssueSeverity = 'error' | 'warning';
+/** A problem found while loading/validating. Never contains secret values. */
+export interface ConfigIssue {
+    severity: ConfigIssueSeverity;
+    /** File relative to the config dir (`config.yaml`, `workflows/coder.yaml`, ...). */
+    file: string;
+    /** Dotted path inside the file, e.g. `execute.timeout.max_duration`, `on_start[1].message`; empty = whole file. */
+    path: string;
+    message: string;
+    /** 1-based line in the file, if known. */
+    line?: number;
+}
+export {};

package/dist/config/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/config/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/config/model.ts"],"names":[],"mappings":""}

package/dist/config/normalize.d.ts

@@ -0,0 +1,20 @@
+import type { GlobalConfig, IdentityConfig, SourceConfig, ViewConfig, WorkflowConfig } from './model.js';
+import type { RawGlobalConfig, RawIdentitiesFile, RawSourcesFile, RawView, RawWorkflow } from './schemas.js';
+/** Resolve a configured directory: absolute stays, relative is taken relative to the config dir. */
+export declare function resolveConfigPath(configDir: string, value: string): string;
+/**
+ * Resolve a configured command: absolute paths are normalized, relative paths
+ * containing `/` (e.g. `scripts/coder.sh`, `./x.sh`) are resolved against the
+ * config dir, bare names (e.g. `bash`) stay untouched for PATH lookup.
+ */
+export declare function resolveCommand(configDir: string, command: string): string;
+/** Normalize `config.yaml`. */
+export declare function normalizeGlobal(raw: RawGlobalConfig, configDir: string, dataDir: string): GlobalConfig;
+/** Normalize `sources.yaml`. */
+export declare function normalizeSources(raw: RawSourcesFile): Record<string, SourceConfig>;
+/** Normalize `identities.yaml`. */
+export declare function normalizeIdentities(raw: RawIdentitiesFile): Record<string, IdentityConfig>;
+/** Normalize one workflow file. */
+export declare function normalizeWorkflow(raw: RawWorkflow, file: string, global: GlobalConfig, configDir: string): WorkflowConfig;
+/** Normalize one view file. */
+export declare function normalizeView(raw: RawView, file: string): ViewConfig;