adispatchd 0.0.0-stage → 0.1.0

package/dist/config/schemas.js

@@ -0,0 +1,321 @@
+/**
+ * zod schemas for the YAML files (Spec §5.1–§5.5, §17, §18).
+ *
+ * The schemas check structure and types, parse durations/sizes and apply
+ * static defaults. Output keeps the YAML (snake_case) structure; the loader
+ * normalizes it into the model of `model.ts` and runs the semantic checks
+ * (references, placeholders, cron, contradictions) in `validate.ts`.
+ *
+ * All objects are strict: unknown keys are reported (typo protection).
+ */
+import { z } from 'zod';
+import { CONFIG_ID_PATTERN, HOOK_NAMES, NOTIFICATION_EVENT_TYPES, parseDuration, parseSize, } from '../core/index.js';
+import { filterNodeSchema } from './filter-schema.js';
+/** Pattern for environment variable names. */
+export const ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Pattern for parameter names (usable as `{parameters.<name>}`). */
+export const PARAMETER_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_-]*$/;
+/** Default `execute.working_directory` (Spec §9). */
+export const DEFAULT_WORKING_DIRECTORY = '{workspace.base_dir}/{workflow.id}/{run.id}';
+/** Static defaults (Spec §5.1, §10, §11, §21). */
+export const DEFAULTS = {
+    serverHost: '127.0.0.1',
+    serverPort: 8787,
+    pollingInterval: '30s',
+    globalMaxConcurrent: 5,
+    workspaceCleanup: 'on_success',
+    actionRetryMaxAttempts: 3,
+    actionRetryDelay: '30s',
+    completedRuns: '30d',
+    failedRuns: '90d',
+    blockedRuns: 'never',
+    maxLogSizePerRun: '100MB',
+    cleanupInterval: '24h',
+    workflowPriority: 0,
+    workflowMaxConcurrent: 1,
+    maxTechnicalFailures: 3,
+    checkTimeout: '30s',
+    shellActionTimeout: '5m',
+    cancelGrace: '30s',
+    scheduleTimezone: 'UTC',
+};
+const configId = z
+    .string()
+    .regex(CONFIG_ID_PATTERN, 'Invalid ID (allowed: letters, digits, "_" and "-", must start with a letter or digit, max. 64)');
+const nonEmpty = z.string().trim().min(1, 'Must not be empty');
+/** Duration like `30s`, parsed to milliseconds. */
+export const durationSchema = z.string('Expected a duration such as 30s, 45m, 6h').transform((value, ctx) => {
+    try {
+        return parseDuration(value);
+    }
+    catch (err) {
+        ctx.addIssue({ code: 'custom', message: err.message });
+        return z.NEVER;
+    }
+});
+/** Duration that must be greater than zero. */
+const positiveDuration = durationSchema.refine((ms) => ms > 0, 'Duration must be greater than 0');
+/** Lower bound of loop intervals (polling, retention cleanup): a zero interval would spin. */
+export const MIN_LOOP_INTERVAL_MS = 1_000;
+/** Interval of a periodic loop: at least {@link MIN_LOOP_INTERVAL_MS}. */
+const loopInterval = durationSchema.refine((ms) => ms >= MIN_LOOP_INTERVAL_MS, 'Duration must be at least 1s');
+/** Duration or `never` (→ `null`). */
+const durationOrNever = z.string('Expected a duration such as 30d or "never"').transform((value, ctx) => {
+    if (value.trim() === 'never')
+        return null;
+    try {
+        return parseDuration(value);
+    }
+    catch (err) {
+        ctx.addIssue({ code: 'custom', message: `${err.message} or "never"` });
+        return z.NEVER;
+    }
+});
+const sizeSchema = z.string('Expected a size such as 100MB').transform((value, ctx) => {
+    try {
+        return parseSize(value);
+    }
+    catch (err) {
+        ctx.addIssue({ code: 'custom', message: err.message });
+        return z.NEVER;
+    }
+});
+const positiveInt = z.number().int('Must be an integer').positive('Must be greater than 0');
+const nonNegativeInt = z.number().int('Must be an integer').min(0, 'Must not be negative');
+const envName = z.string().regex(ENV_NAME_PATTERN, 'Invalid environment variable name');
+/** Env values: YAML scalars are accepted and stringified (`PORT: 8080`). */
+const envMap = z
+    .record(envName, z.union([z.string(), z.number(), z.boolean()]).transform((v) => String(v)))
+    .default({});
+const stringList = z.array(z.string()).default([]);
+const notificationEvent = z.enum(NOTIFICATION_EVENT_TYPES);
+// ---------------------------------------------------------------------------
+// config.yaml
+// ---------------------------------------------------------------------------
+const retryPolicySchema = z.strictObject({
+    max_attempts: positiveInt.default(DEFAULTS.actionRetryMaxAttempts),
+    delay: durationSchema.default(parseDuration(DEFAULTS.actionRetryDelay)),
+});
+const webhookChannelSchema = z.strictObject({
+    id: configId.optional(),
+    type: z.literal('webhook'),
+    url: z.string().optional(),
+    url_env: envName.optional(),
+    headers_env: z.record(z.string().regex(/^[A-Za-z0-9-]+$/, 'Invalid HTTP header name'), envName).default({}),
+    on: z.array(notificationEvent).optional(),
+});
+/** Schema of `config.yaml`. */
+export const globalConfigSchema = z.strictObject({
+    server: z
+        .strictObject({
+        host: nonEmpty.default(DEFAULTS.serverHost),
+        port: z.number().int().min(1).max(65535).default(DEFAULTS.serverPort),
+        /**
+         * Additional host names (optionally `name:port`) accepted in the `Host` / `Origin`
+         * header, e.g. the public name of an authenticating reverse proxy (DNS-rebinding protection).
+         */
+        allowed_hosts: z
+            .array(z.string().regex(/^(\[[0-9a-fA-F:.]+\]|[A-Za-z0-9.-]+)(:\d{1,5})?$/, 'Invalid host name (expected "name" or "name:port")'))
+            .default([]),
+    })
+        .default({ host: DEFAULTS.serverHost, port: DEFAULTS.serverPort, allowed_hosts: [] }),
+    scheduler: z
+        .strictObject({
+        polling_interval: loopInterval.default(parseDuration(DEFAULTS.pollingInterval)),
+        max_concurrent: positiveInt.default(DEFAULTS.globalMaxConcurrent),
+    })
+        .prefault({}),
+    workspace: z
+        .strictObject({
+        base_dir: nonEmpty.optional(),
+        cleanup: z.enum(['always', 'on_success', 'never']).default(DEFAULTS.workspaceCleanup),
+    })
+        .prefault({}),
+    lifecycle: z.strictObject({ action_retry: retryPolicySchema.prefault({}) }).prefault({}),
+    retention: z
+        .strictObject({
+        completed_runs: durationOrNever.default(parseDuration(DEFAULTS.completedRuns)),
+        failed_runs: durationOrNever.default(parseDuration(DEFAULTS.failedRuns)),
+        blocked_runs: durationOrNever.default(null),
+        max_log_size_per_run: sizeSchema.default(parseSize(DEFAULTS.maxLogSizePerRun)),
+        cleanup_interval: loopInterval.default(parseDuration(DEFAULTS.cleanupInterval)),
+    })
+        .prefault({}),
+    notifications: z
+        .strictObject({
+        on: z.array(notificationEvent).default([...NOTIFICATION_EVENT_TYPES]),
+        channels: z.array(z.discriminatedUnion('type', [webhookChannelSchema])).default([]),
+    })
+        .prefault({}),
+});
+// ---------------------------------------------------------------------------
+// sources.yaml / identities.yaml
+// ---------------------------------------------------------------------------
+const githubSourceSchema = z.strictObject({
+    type: z.literal('github'),
+    owner: nonEmpty,
+    repository: nonEmpty,
+    identity: configId,
+});
+/** Schema of `sources.yaml`. */
+export const sourcesFileSchema = z.strictObject({
+    sources: z.record(configId, z.discriminatedUnion('type', [githubSourceSchema])).default({}),
+});
+const githubAppIdentitySchema = z.strictObject({
+    type: z.literal('github_app'),
+    app_id: positiveInt,
+    installation_id: positiveInt,
+    private_key_env: envName,
+});
+/** Schema of `identities.yaml`. */
+export const identitiesFileSchema = z.strictObject({
+    identities: z.record(configId, z.discriminatedUnion('type', [githubAppIdentitySchema])).default({}),
+});
+// ---------------------------------------------------------------------------
+// workflows/*.yaml
+// ---------------------------------------------------------------------------
+const triggerSchema = z.discriminatedUnion('type', [
+    z.strictObject({ type: z.literal('source'), source: configId }),
+    z.strictObject({
+        type: z.literal('schedule'),
+        cron: nonEmpty,
+        timezone: nonEmpty.default(DEFAULTS.scheduleTimezone),
+    }),
+    z.strictObject({ type: z.literal('manual') }),
+]);
+const shellCheckSchema = z.strictObject({
+    type: z.literal('shell'),
+    command: nonEmpty,
+    args: stringList,
+    timeout: positiveDuration.default(parseDuration(DEFAULTS.checkTimeout)),
+    cache: durationSchema.optional(),
+});
+const shellFilterSchema = z.strictObject({
+    command: nonEmpty,
+    timeout: positiveDuration.default(parseDuration(DEFAULTS.checkTimeout)),
+});
+const itemPrioritySchema = z.strictObject({
+    rules: z.array(z.strictObject({ when: filterNodeSchema, value: z.number() })).default([]),
+    default: z.number().default(0),
+});
+const parameterBase = {
+    required: z.boolean().default(false),
+    description: z.string().optional(),
+};
+const parameterSchema = z.discriminatedUnion('type', [
+    z.strictObject({ type: z.literal('string'), ...parameterBase, default: z.unknown().optional() }),
+    z.strictObject({ type: z.literal('number'), ...parameterBase, default: z.unknown().optional() }),
+    z.strictObject({ type: z.literal('boolean'), ...parameterBase, default: z.unknown().optional() }),
+    z.strictObject({
+        type: z.literal('enum'),
+        ...parameterBase,
+        values: z.array(z.union([z.string(), z.number(), z.boolean()]).transform(String)).min(1, 'Enum needs values'),
+        // Scalars are stringified like `values`, so `values: [1, 2]` + `default: 1` matches.
+        default: z
+            .unknown()
+            .optional()
+            .transform((v) => (typeof v === 'number' || typeof v === 'boolean' ? String(v) : v)),
+    }),
+]);
+const executeSchema = z.discriminatedUnion('type', [
+    z.strictObject({
+        type: z.literal('shell'),
+        command: nonEmpty,
+        args: stringList,
+        working_directory: nonEmpty.default(DEFAULT_WORKING_DIRECTORY),
+        create_directory: z.boolean().default(true),
+        env: envMap,
+        secrets: z.record(envName, z.strictObject({ identity: configId })).default({}),
+        timeout: z
+            .strictObject({
+            max_duration: positiveDuration.optional(),
+            idle_timeout: positiveDuration.optional(),
+        })
+            .default({}),
+        cancel_grace: durationSchema.default(parseDuration(DEFAULTS.cancelGrace)),
+    }),
+]);
+const actionCommon = {
+    id: configId.optional(),
+    continue_on_error: z.boolean().default(false),
+    retry: z
+        .strictObject({
+        max_attempts: positiveInt.optional(),
+        delay: durationSchema.optional(),
+    })
+        .optional(),
+};
+const actionSchema = z.discriminatedUnion('type', [
+    z.strictObject({
+        type: z.literal('source.update'),
+        ...actionCommon,
+        labels: z.strictObject({ add: stringList, remove: stringList }),
+    }),
+    z.strictObject({
+        type: z.literal('source.comment'),
+        ...actionCommon,
+        message: nonEmpty,
+        identity: configId.optional(),
+    }),
+    z.strictObject({
+        type: z.literal('shell'),
+        ...actionCommon,
+        command: nonEmpty,
+        args: stringList,
+        timeout: positiveDuration.default(parseDuration(DEFAULTS.shellActionTimeout)),
+        env: envMap,
+    }),
+]);
+const hookList = z.array(actionSchema).default([]);
+const hookShape = Object.fromEntries(HOOK_NAMES.map((h) => [h, hookList]));
+/** Schema of one `workflows/*.yaml` file. */
+export const workflowSchema = z.strictObject({
+    id: configId,
+    name: nonEmpty.optional(),
+    enabled: z.boolean().default(true),
+    priority: z.number().default(DEFAULTS.workflowPriority),
+    max_concurrent: positiveInt.default(DEFAULTS.workflowMaxConcurrent),
+    identity: configId.optional(),
+    trigger: triggerSchema,
+    filter: filterNodeSchema.optional(),
+    shell_filter: shellFilterSchema.optional(),
+    item_priority: itemPrioritySchema.optional(),
+    conditions: z
+        .strictObject({
+        workflow: z.array(shellCheckSchema).default([]),
+        item: z.array(shellCheckSchema).default([]),
+    })
+        .prefault({}),
+    parameters: z.record(z.string().regex(PARAMETER_NAME_PATTERN, 'Invalid parameter name'), parameterSchema).default({}),
+    execute: executeSchema,
+    retry: z
+        .strictObject({ max_technical_failures: positiveInt.default(DEFAULTS.maxTechnicalFailures) })
+        .prefault({}),
+    ...hookShape,
+});
+// ---------------------------------------------------------------------------
+// views/*.yaml
+// ---------------------------------------------------------------------------
+/** Schema of one `views/*.yaml` file. */
+export const viewSchema = z.strictObject({
+    id: configId,
+    title: nonEmpty.optional(),
+    sources: z.array(configId).min(1, 'A view needs at least one source'),
+    filter: filterNodeSchema.optional(),
+    /** Not allowed in views (Spec §6, §17); accepted here to report a precise error in validate.ts. */
+    shell_filter: z.unknown().optional(),
+    fields: z
+        .array(z.strictObject({
+        field: nonEmpty,
+        label: z.string().optional(),
+        link: nonEmpty.optional(),
+    }))
+        .min(1, 'A view needs at least one field'),
+    sort: z
+        .strictObject({
+        field: nonEmpty,
+        direction: z.enum(['asc', 'desc']).default('asc'),
+    })
+        .optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/config/schemas.js.map

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

package/dist/config/snapshot.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Workflow snapshots for `runs.config_snapshot` (Spec §19): a run and its
+ * hooks keep using the configuration that was active at start, even after a
+ * reload. Snapshots are plain JSON and contain no secrets — identities are
+ * referenced by ID only, notification channels are not included.
+ */
+import { OrchestratorError } from '../core/index.js';
+import type { LoadedConfig, SourceConfig, WorkflowConfig, WorkspaceConfig } from './model.js';
+/** Current snapshot format version. */
+export declare const WORKFLOW_SNAPSHOT_VERSION = 1;
+/** Serializable configuration snapshot of one workflow. */
+export interface WorkflowSnapshot {
+    schemaVersion: typeof WORKFLOW_SNAPSHOT_VERSION;
+    configHash: string;
+    configVersion: number;
+    workflowHash: string;
+    /** Workflow as configured (runtime overrides are not part of the snapshot). */
+    workflow: WorkflowConfig;
+    /** Source of a source-triggered workflow, otherwise `null`. */
+    source: SourceConfig | null;
+    workspace: WorkspaceConfig;
+    /** IDs of all identities the workflow can use (workflow, source, secrets, actions). */
+    identityRefs: string[];
+}
+/** Thrown when a workflow ID is not part of the configuration. */
+export declare class UnknownWorkflowError extends OrchestratorError {
+    readonly workflowId: string;
+    constructor(workflowId: string);
+}
+/** Identities a workflow may use, sorted. */
+export declare function workflowIdentityRefs(workflow: WorkflowConfig, source: SourceConfig | null): string[];
+/**
+ * Build a JSON-serializable snapshot of `workflowId`. The result is a deep
+ * copy (mutable, independent of the frozen config).
+ *
+ * @throws UnknownWorkflowError
+ */
+export declare function snapshotWorkflow(config: LoadedConfig, workflowId: string): WorkflowSnapshot;

package/dist/config/snapshot.js

@@ -0,0 +1,57 @@
+/**
+ * Workflow snapshots for `runs.config_snapshot` (Spec §19): a run and its
+ * hooks keep using the configuration that was active at start, even after a
+ * reload. Snapshots are plain JSON and contain no secrets — identities are
+ * referenced by ID only, notification channels are not included.
+ */
+import { OrchestratorError } from '../core/index.js';
+/** Current snapshot format version. */
+export const WORKFLOW_SNAPSHOT_VERSION = 1;
+/** Thrown when a workflow ID is not part of the configuration. */
+export class UnknownWorkflowError extends OrchestratorError {
+    workflowId;
+    constructor(workflowId) {
+        super('config_unknown_workflow', `Unknown workflow "${workflowId}"`, { details: { workflowId } });
+        this.workflowId = workflowId;
+    }
+}
+/** Identities a workflow may use, sorted. */
+export function workflowIdentityRefs(workflow, source) {
+    const refs = new Set();
+    if (workflow.identity)
+        refs.add(workflow.identity);
+    if (source)
+        refs.add(source.identity);
+    for (const ref of Object.values(workflow.execute.secrets))
+        refs.add(ref.identity);
+    for (const actions of Object.values(workflow.hooks)) {
+        for (const action of actions)
+            if (action.type === 'source.comment' && action.identity)
+                refs.add(action.identity);
+    }
+    return [...refs].sort();
+}
+/**
+ * Build a JSON-serializable snapshot of `workflowId`. The result is a deep
+ * copy (mutable, independent of the frozen config).
+ *
+ * @throws UnknownWorkflowError
+ */
+export function snapshotWorkflow(config, workflowId) {
+    const workflow = Object.hasOwn(config.workflows, workflowId) ? config.workflows[workflowId] : undefined;
+    if (!workflow)
+        throw new UnknownWorkflowError(workflowId);
+    const source = workflow.trigger.type === 'source' ? (config.sources[workflow.trigger.source] ?? null) : null;
+    const snapshot = {
+        schemaVersion: WORKFLOW_SNAPSHOT_VERSION,
+        configHash: config.hash,
+        configVersion: config.version,
+        workflowHash: config.workflowHashes[workflowId] ?? '',
+        workflow,
+        source,
+        workspace: config.global.workspace,
+        identityRefs: workflowIdentityRefs(workflow, source),
+    };
+    return JSON.parse(JSON.stringify(snapshot));
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/config/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/config/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,uCAAuC;AACvC,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAiB3C,kEAAkE;AAClE,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IACpC,UAAU;IAA/B,YAAqB,UAAkB;QACrC,KAAK,CAAC,yBAAyB,EAAE,qBAAqB,UAAU,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;0BAD/E,UAAU;IAE/B,CAAC;CACF;AAED,6CAA6C;AAC7C,MAAM,UAAU,oBAAoB,CAAC,QAAwB,EAAE,MAA2B;IACxF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,QAAQ,CAAC,QAAQ;QAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,MAAM;QAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClF,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,KAAK,MAAM,MAAM,IAAI,OAAO;YAAE,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,IAAI,MAAM,CAAC,QAAQ;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB,EAAE,UAAkB;IACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxG,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7G,MAAM,QAAQ,GAAqB;QACjC,aAAa,EAAE,yBAAyB;QACxC,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,aAAa,EAAE,MAAM,CAAC,OAAO;QAC7B,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE;QACrD,QAAQ;QACR,MAAM;QACN,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS;QAClC,YAAY,EAAE,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC;KACrD,CAAC;IACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAqB,CAAC;AAClE,CAAC"}

package/dist/config/validate.d.ts

@@ -0,0 +1,33 @@
+import type { IssueCollector } from './issues.js';
+import type { GlobalConfig, IdentityConfig, SourceConfig, ViewConfig, WorkflowConfig } from './model.js';
+import type { RawParameter } from './schemas.js';
+/** Files of the top-level documents. */
+export declare const CONFIG_FILE = "config.yaml";
+export declare const SOURCES_FILE = "sources.yaml";
+export declare const IDENTITIES_FILE = "identities.yaml";
+/** Env variable prefix reserved for the orchestrator (Spec §9.1). */
+export declare const RESERVED_ENV_PREFIX = "ADISPATCH_";
+/** A workflow together with the raw data needed for checks the model cannot express. */
+export interface WorkflowEntry {
+    workflow: WorkflowConfig;
+    rawParameters: Readonly<Record<string, RawParameter>>;
+}
+/** A view together with raw flags. */
+export interface ViewEntry {
+    view: ViewConfig;
+    hasShellFilter: boolean;
+}
+/** Input of {@link validateSemantics}. */
+export interface SemanticInput {
+    global: GlobalConfig;
+    sources: Readonly<Record<string, SourceConfig>>;
+    identities: Readonly<Record<string, IdentityConfig>>;
+    workflows: readonly WorkflowEntry[];
+    views: readonly ViewEntry[];
+}
+/** True if `tz` is a valid IANA time zone for this runtime. */
+export declare function isValidTimeZone(tz: string): boolean;
+/** Validate a cron expression (croner syntax); returns an error message or `undefined`. */
+export declare function cronError(expression: string, timezone?: string): string | undefined;
+/** Run all semantic checks and add problems to `issues`. */
+export declare function validateSemantics(input: SemanticInput, issues: IssueCollector): void;