@taskcast/core 0.1.2 → 0.3.0

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type TaskStatus = 'pending' | 'running' | 'completed' | 'failed' | 'timeout' | 'cancelled';
+export type TaskStatus = 'pending' | 'assigned' | 'running' | 'paused' | 'blocked' | 'completed' | 'failed' | 'timeout' | 'cancelled';
 export interface TaskError {
     code?: string;
     message: string;
@@ -31,7 +31,7 @@ export interface RetryConfig {
 }
 export type SeriesMode = 'keep-all' | 'accumulate' | 'latest';
 export type Level = 'debug' | 'info' | 'warn' | 'error';
-export type PermissionScope = 'task:create' | 'task:manage' | 'event:publish' | 'event:subscribe' | 'event:history' | 'webhook:create' | '*';
+export type PermissionScope = 'task:create' | 'task:manage' | 'event:publish' | 'event:subscribe' | 'event:history' | 'webhook:create' | 'worker:connect' | 'worker:manage' | '*';
 export interface CleanupRule {
     name?: string;
     match?: {
@@ -49,6 +49,45 @@ export interface CleanupRule {
         seriesMode?: SeriesMode[];
     };
 }
+export type AssignMode = 'external' | 'pull' | 'ws-offer' | 'ws-race';
+export type DisconnectPolicy = 'reassign' | 'mark' | 'fail';
+export type WorkerStatus = 'idle' | 'busy' | 'draining' | 'offline';
+export interface TagMatcher {
+    all?: string[];
+    any?: string[];
+    none?: string[];
+}
+export interface WorkerMatchRule {
+    taskTypes?: string[];
+    tags?: TagMatcher;
+}
+export interface Worker {
+    id: string;
+    status: WorkerStatus;
+    matchRule: WorkerMatchRule;
+    capacity: number;
+    usedSlots: number;
+    weight: number;
+    connectionMode: 'pull' | 'websocket';
+    connectedAt: number;
+    lastHeartbeatAt: number;
+    metadata?: Record<string, unknown>;
+}
+export type WorkerAssignmentStatus = 'offered' | 'assigned' | 'running';
+export interface WorkerAssignment {
+    taskId: string;
+    workerId: string;
+    cost: number;
+    assignedAt: number;
+    status: WorkerAssignmentStatus;
+}
+export interface WorkerAuditEvent {
+    id: string;
+    workerId: string;
+    timestamp: number;
+    action: 'connected' | 'disconnected' | 'updated' | 'task_assigned' | 'task_declined' | 'task_reclaimed' | 'draining' | 'heartbeat_timeout' | 'pull_request';
+    data?: Record<string, unknown>;
+}
 export interface Task {
     id: string;
     type?: string;
@@ -66,6 +105,11 @@ export interface Task {
     cleanup?: {
         rules: CleanupRule[];
     };
+    tags?: string[];
+    assignMode?: AssignMode;
+    cost?: number;
+    assignedWorker?: string;
+    disconnectPolicy?: DisconnectPolicy;
 }
 export interface TaskEvent {
     id: string;
@@ -121,12 +165,36 @@ export interface ShortTermStore {
     getSeriesLatest(taskId: string, seriesId: string): Promise<TaskEvent | null>;
     setSeriesLatest(taskId: string, seriesId: string, event: TaskEvent): Promise<void>;
     replaceLastSeriesEvent(taskId: string, seriesId: string, event: TaskEvent): Promise<void>;
+    listTasks(filter: TaskFilter): Promise<Task[]>;
+    saveWorker(worker: Worker): Promise<void>;
+    getWorker(workerId: string): Promise<Worker | null>;
+    listWorkers(filter?: WorkerFilter): Promise<Worker[]>;
+    deleteWorker(workerId: string): Promise<void>;
+    claimTask(taskId: string, workerId: string, cost: number): Promise<boolean>;
+    addAssignment(assignment: WorkerAssignment): Promise<void>;
+    removeAssignment(taskId: string): Promise<void>;
+    getWorkerAssignments(workerId: string): Promise<WorkerAssignment[]>;
+    getTaskAssignment(taskId: string): Promise<WorkerAssignment | null>;
 }
 export interface LongTermStore {
     saveTask(task: Task): Promise<void>;
     getTask(taskId: string): Promise<Task | null>;
     saveEvent(event: TaskEvent): Promise<void>;
     getEvents(taskId: string, opts?: EventQueryOptions): Promise<TaskEvent[]>;
+    saveWorkerEvent(event: WorkerAuditEvent): Promise<void>;
+    getWorkerEvents(workerId: string, opts?: EventQueryOptions): Promise<WorkerAuditEvent[]>;
+}
+export interface TaskFilter {
+    status?: TaskStatus[];
+    types?: string[];
+    tags?: TagMatcher;
+    assignMode?: AssignMode[];
+    excludeTaskIds?: string[];
+    limit?: number;
+}
+export interface WorkerFilter {
+    status?: WorkerStatus[];
+    connectionMode?: ('pull' | 'websocket')[];
 }
 export interface ErrorContext {
     operation: string;
@@ -140,5 +208,11 @@ export interface TaskcastHooks {
     onWebhookFailed?(config: WebhookConfig, err: unknown): void;
     onSSEConnect?(taskId: string, clientId: string): void;
     onSSEDisconnect?(taskId: string, clientId: string, duration: number): void;
+    onTaskCreated?(task: Task): void;
+    onTaskTransitioned?(task: Task, from: TaskStatus, to: TaskStatus): void;
+    onWorkerConnected?(worker: Worker): void;
+    onWorkerDisconnected?(worker: Worker, reason: string): void;
+    onTaskAssigned?(task: Task, worker: Worker): void;
+    onTaskDeclined?(task: Task, worker: Worker, blacklisted: boolean): void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/worker-manager.d.ts

@@ -0,0 +1,67 @@
+import type { Task, Worker, WorkerFilter, WorkerAssignment, BroadcastProvider, ShortTermStore, LongTermStore, TaskcastHooks, AssignMode, DisconnectPolicy, WorkerMatchRule } from './types.js';
+import type { TaskEngine } from './engine.js';
+export interface WorkerManagerOptions {
+    engine: TaskEngine;
+    shortTermStore: ShortTermStore;
+    broadcast: BroadcastProvider;
+    longTermStore?: LongTermStore;
+    hooks?: TaskcastHooks;
+    defaults?: WorkerManagerDefaults;
+}
+export interface WorkerManagerDefaults {
+    assignMode?: AssignMode;
+    heartbeatIntervalMs?: number;
+    heartbeatTimeoutMs?: number;
+    offerTimeoutMs?: number;
+    disconnectPolicy?: DisconnectPolicy;
+    disconnectGraceMs?: number;
+}
+export interface WorkerRegistration {
+    id?: string;
+    matchRule: WorkerMatchRule;
+    capacity: number;
+    weight?: number;
+    connectionMode: Worker['connectionMode'];
+    metadata?: Record<string, unknown>;
+}
+export interface WorkerUpdate {
+    weight?: number;
+    capacity?: number;
+    matchRule?: WorkerMatchRule;
+    status?: 'draining';
+}
+export interface DispatchResult {
+    matched: boolean;
+    workerId?: string;
+}
+export interface ClaimResult {
+    success: boolean;
+    reason?: string;
+}
+export interface DeclineOptions {
+    blacklist?: boolean;
+}
+export declare class WorkerManager {
+    private opts;
+    private engine;
+    private shortTermStore;
+    private longTermStore?;
+    private hooks?;
+    constructor(opts: WorkerManagerOptions);
+    get heartbeatIntervalMs(): number;
+    private emitTaskAudit;
+    private emitWorkerAudit;
+    registerWorker(config: WorkerRegistration): Promise<Worker>;
+    unregisterWorker(workerId: string): Promise<void>;
+    updateWorker(workerId: string, update: WorkerUpdate): Promise<Worker | null>;
+    heartbeat(workerId: string): Promise<void>;
+    getWorker(workerId: string): Promise<Worker | null>;
+    listWorkers(filter?: WorkerFilter): Promise<Worker[]>;
+    dispatchTask(taskId: string): Promise<DispatchResult>;
+    claimTask(taskId: string, workerId: string): Promise<ClaimResult>;
+    declineTask(taskId: string, workerId: string, opts?: DeclineOptions): Promise<void>;
+    getWorkerTasks(workerId: string): Promise<WorkerAssignment[]>;
+    waitForTask(workerId: string, signal?: AbortSignal): Promise<Task>;
+    notifyNewTask(taskId: string): Promise<void>;
+}
+//# sourceMappingURL=worker-manager.d.ts.map

package/dist/worker-manager.d.ts.map

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

package/dist/worker-manager.js

@@ -0,0 +1,312 @@
+import { ulid } from 'ulidx';
+import { matchesWorkerRule } from './worker-matching.js';
+// ─── WorkerManager ──────────────────────────────────────────────────────────
+export class WorkerManager {
+    opts;
+    engine;
+    shortTermStore;
+    longTermStore;
+    hooks;
+    constructor(opts) {
+        this.opts = opts;
+        this.engine = opts.engine;
+        this.shortTermStore = opts.shortTermStore;
+        if (opts.longTermStore)
+            this.longTermStore = opts.longTermStore;
+        if (opts.hooks)
+            this.hooks = opts.hooks;
+    }
+    get heartbeatIntervalMs() {
+        return this.opts.defaults?.heartbeatIntervalMs ?? 30_000;
+    }
+    // ─── Audit Helpers ──────────────────────────────────────────────────────
+    async emitTaskAudit(taskId, action, extra) {
+        try {
+            await this.opts.engine.publishEvent(taskId, {
+                type: 'taskcast:audit',
+                level: 'info',
+                data: { action, ...extra },
+            });
+        }
+        catch {
+            // Task may be in terminal state or not found; audit is best-effort
+        }
+    }
+    emitWorkerAudit(action, workerId, data) {
+        if (!this.opts.longTermStore)
+            return;
+        const event = {
+            id: ulid(),
+            workerId,
+            timestamp: Date.now(),
+            action,
+            ...(data !== undefined && { data }),
+        };
+        this.opts.longTermStore.saveWorkerEvent(event).catch(() => { });
+    }
+    // ─── Worker Registration & Lifecycle ────────────────────────────────────
+    async registerWorker(config) {
+        const now = Date.now();
+        const worker = {
+            id: config.id ?? ulid(),
+            status: 'idle',
+            matchRule: config.matchRule,
+            capacity: config.capacity,
+            usedSlots: 0,
+            weight: config.weight ?? 50,
+            connectionMode: config.connectionMode,
+            connectedAt: now,
+            lastHeartbeatAt: now,
+            ...(config.metadata !== undefined && { metadata: config.metadata }),
+        };
+        await this.shortTermStore.saveWorker(worker);
+        this.emitWorkerAudit('connected', worker.id);
+        this.hooks?.onWorkerConnected?.(worker);
+        return worker;
+    }
+    async unregisterWorker(workerId) {
+        const worker = await this.shortTermStore.getWorker(workerId);
+        await this.shortTermStore.deleteWorker(workerId);
+        if (worker) {
+            this.emitWorkerAudit('disconnected', workerId, { reason: 'unregistered' });
+            this.hooks?.onWorkerDisconnected?.(worker, 'unregistered');
+        }
+    }
+    async updateWorker(workerId, update) {
+        const worker = await this.shortTermStore.getWorker(workerId);
+        if (!worker)
+            return null;
+        if (update.weight !== undefined)
+            worker.weight = update.weight;
+        if (update.capacity !== undefined)
+            worker.capacity = update.capacity;
+        if (update.matchRule !== undefined)
+            worker.matchRule = update.matchRule;
+        if (update.status !== undefined)
+            worker.status = update.status;
+        await this.shortTermStore.saveWorker(worker);
+        return worker;
+    }
+    async heartbeat(workerId) {
+        const worker = await this.shortTermStore.getWorker(workerId);
+        if (!worker)
+            return;
+        worker.lastHeartbeatAt = Date.now();
+        await this.shortTermStore.saveWorker(worker);
+    }
+    async getWorker(workerId) {
+        return this.shortTermStore.getWorker(workerId);
+    }
+    async listWorkers(filter) {
+        return this.shortTermStore.listWorkers(filter);
+    }
+    // ─── Task Dispatch ─────────────────────────────────────────────────────
+    async dispatchTask(taskId) {
+        const task = await this.engine.getTask(taskId);
+        if (!task || task.status !== 'pending') {
+            return { matched: false };
+        }
+        const blacklist = task.metadata?._blacklistedWorkers ?? [];
+        const workers = await this.shortTermStore.listWorkers({ status: ['idle', 'busy'] });
+        const taskCost = task.cost ?? 1;
+        const candidates = workers.filter((w) => {
+            if (blacklist.includes(w.id))
+                return false;
+            if (w.usedSlots + taskCost > w.capacity)
+                return false;
+            if (!matchesWorkerRule(task, w.matchRule))
+                return false;
+            return true;
+        });
+        if (candidates.length === 0) {
+            return { matched: false };
+        }
+        // Sort: weight desc → available slots desc → connectedAt asc
+        candidates.sort((a, b) => {
+            if (b.weight !== a.weight)
+                return b.weight - a.weight;
+            const aAvailable = a.capacity - a.usedSlots;
+            const bAvailable = b.capacity - b.usedSlots;
+            if (bAvailable !== aAvailable)
+                return bAvailable - aAvailable;
+            return a.connectedAt - b.connectedAt;
+        });
+        return { matched: true, workerId: candidates[0].id };
+    }
+    // ─── Task Claim ────────────────────────────────────────────────────────
+    async claimTask(taskId, workerId) {
+        const task = await this.engine.getTask(taskId);
+        if (!task) {
+            return { success: false, reason: 'Task not found' };
+        }
+        if (task.status !== 'pending') {
+            return { success: false, reason: `Task is not pending (status: ${task.status})` };
+        }
+        const cost = task.cost ?? 1;
+        const claimed = await this.shortTermStore.claimTask(taskId, workerId, cost);
+        if (!claimed) {
+            return { success: false, reason: 'Claim failed (concurrent modification)' };
+        }
+        // claimTask atomically sets status to 'assigned' and assignedWorker on the
+        // store.  Re-read to get the authoritative state, then persist to longTermStore.
+        const updatedTask = (await this.shortTermStore.getTask(taskId));
+        if (this.longTermStore)
+            await this.longTermStore.saveTask(updatedTask);
+        // Emit audit events for the claim
+        this.emitWorkerAudit('task_assigned', workerId, { taskId });
+        await this.emitTaskAudit(taskId, 'assigned', { workerId });
+        // Create assignment record
+        const assignment = {
+            taskId,
+            workerId,
+            cost,
+            assignedAt: Date.now(),
+            status: 'assigned',
+        };
+        await this.shortTermStore.addAssignment(assignment);
+        // Update worker status (usedSlots already updated by claimTask)
+        const worker = await this.shortTermStore.getWorker(workerId);
+        if (worker) {
+            worker.status = worker.usedSlots >= worker.capacity ? 'busy' : 'idle';
+            await this.shortTermStore.saveWorker(worker);
+            this.hooks?.onTaskAssigned?.(updatedTask, worker);
+        }
+        return { success: true };
+    }
+    // ─── Task Decline ──────────────────────────────────────────────────────
+    async declineTask(taskId, workerId, opts) {
+        const assignment = await this.shortTermStore.getTaskAssignment(taskId);
+        if (!assignment || assignment.workerId !== workerId)
+            return;
+        // Remove assignment
+        await this.shortTermStore.removeAssignment(taskId);
+        // Restore worker capacity
+        const worker = await this.shortTermStore.getWorker(workerId);
+        if (worker) {
+            worker.usedSlots = Math.max(0, worker.usedSlots - assignment.cost);
+            worker.status = 'idle';
+            await this.shortTermStore.saveWorker(worker);
+        }
+        // Transition task back to pending
+        await this.engine.transitionTask(taskId, 'pending');
+        // Emit audit events for the decline
+        const blacklisted = opts?.blacklist ?? false;
+        this.emitWorkerAudit('task_declined', workerId, { taskId });
+        await this.emitTaskAudit(taskId, 'declined', { workerId, blacklisted });
+        // Clear assignedWorker
+        const task = await this.engine.getTask(taskId);
+        if (task) {
+            delete task.assignedWorker;
+            // Add to blacklist if requested
+            if (opts?.blacklist) {
+                const metadata = task.metadata ?? {};
+                const existing = metadata._blacklistedWorkers ?? [];
+                metadata._blacklistedWorkers = [...existing, workerId];
+                task.metadata = metadata;
+            }
+            await this.shortTermStore.saveTask(task);
+            if (this.longTermStore)
+                await this.longTermStore.saveTask(task);
+            if (worker) {
+                this.hooks?.onTaskDeclined?.(task, worker, blacklisted);
+            }
+        }
+    }
+    // ─── Worker Tasks ──────────────────────────────────────────────────────
+    async getWorkerTasks(workerId) {
+        return this.shortTermStore.getWorkerAssignments(workerId);
+    }
+    // ─── Pull Mode (Long-Poll) ─────────────────────────────────────────────
+    async waitForTask(workerId, signal) {
+        const worker = await this.shortTermStore.getWorker(workerId);
+        if (!worker)
+            throw new Error(`Worker not found: ${workerId}`);
+        // Check if already aborted
+        if (signal?.aborted) {
+            throw new Error('aborted');
+        }
+        // Check existing pending pull tasks
+        const pendingTasks = await this.shortTermStore.listTasks({ status: ['pending'], assignMode: ['pull'] });
+        const blacklist = new Set();
+        for (const task of pendingTasks) {
+            const taskBlacklist = task.metadata?._blacklistedWorkers ?? [];
+            if (taskBlacklist.includes(workerId))
+                continue;
+            if (!matchesWorkerRule(task, worker.matchRule))
+                continue;
+            const taskCost = task.cost ?? 1;
+            if (worker.usedSlots + taskCost > worker.capacity)
+                continue;
+            const result = await this.claimTask(task.id, workerId);
+            if (result.success) {
+                this.emitWorkerAudit('pull_request', workerId, { matched: true, taskId: task.id });
+                const claimed = await this.engine.getTask(task.id);
+                return claimed;
+            }
+        }
+        // Wait for a new task notification via broadcast
+        return new Promise((resolve, reject) => {
+            let unsubscribe;
+            const cleanup = () => {
+                unsubscribe?.();
+                signal?.removeEventListener('abort', onAbort);
+            };
+            const onAbort = () => {
+                cleanup();
+                this.emitWorkerAudit('pull_request', workerId, { matched: false });
+                reject(new Error('aborted'));
+            };
+            if (signal) {
+                signal.addEventListener('abort', onAbort);
+            }
+            unsubscribe = this.opts.broadcast.subscribe('taskcast:worker:new-task', async (event) => {
+                const taskId = event.data;
+                try {
+                    // Re-fetch the worker to get current state
+                    const currentWorker = await this.shortTermStore.getWorker(workerId);
+                    if (!currentWorker) {
+                        cleanup();
+                        reject(new Error(`Worker not found: ${workerId}`));
+                        return;
+                    }
+                    const task = await this.engine.getTask(taskId);
+                    if (!task || task.status !== 'pending')
+                        return;
+                    if (task.assignMode !== 'pull')
+                        return;
+                    const taskBlacklist = task.metadata?._blacklistedWorkers ?? [];
+                    if (taskBlacklist.includes(workerId))
+                        return;
+                    if (!matchesWorkerRule(task, currentWorker.matchRule))
+                        return;
+                    const taskCost = task.cost ?? 1;
+                    if (currentWorker.usedSlots + taskCost > currentWorker.capacity)
+                        return;
+                    const result = await this.claimTask(taskId, workerId);
+                    if (result.success) {
+                        cleanup();
+                        this.emitWorkerAudit('pull_request', workerId, { matched: true, taskId });
+                        const claimed = await this.engine.getTask(taskId);
+                        resolve(claimed);
+                    }
+                }
+                catch {
+                    // Ignore errors from individual task checks
+                }
+            });
+        });
+    }
+    async notifyNewTask(taskId) {
+        const event = {
+            id: ulid(),
+            taskId: 'system',
+            index: 0,
+            timestamp: Date.now(),
+            type: 'taskcast:worker:new-task',
+            level: 'info',
+            data: taskId,
+        };
+        await this.opts.broadcast.publish('taskcast:worker:new-task', event);
+    }
+}
+//# sourceMappingURL=worker-manager.js.map

package/dist/worker-manager.js.map

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

package/dist/worker-matching.d.ts

@@ -0,0 +1,23 @@
+import type { Task, TagMatcher, WorkerMatchRule } from './types.js';
+/**
+ * Checks if a set of task tags matches a TagMatcher.
+ *
+ * - `all`: every tag in `all` must exist in taskTags
+ * - `any`: at least one tag in `any` must exist in taskTags
+ * - `none`: none of the tags in `none` may exist in taskTags
+ * - Empty/undefined matcher matches everything
+ * - Undefined taskTags treated as empty array
+ * - Empty arrays in matcher fields are vacuous true
+ */
+export declare function matchesTag(taskTags: string[] | undefined, matcher: TagMatcher): boolean;
+/**
+ * Checks if a task matches a WorkerMatchRule.
+ *
+ * - If rule has `taskTypes`: task.type must match using wildcard matching
+ * - If rule has `tags`: use matchesTag
+ * - Both conditions are AND'd
+ * - Empty/no rule matches everything
+ * - Task with no `type` does not match if rule has `taskTypes`
+ */
+export declare function matchesWorkerRule(task: Task, rule: WorkerMatchRule): boolean;
+//# sourceMappingURL=worker-matching.d.ts.map

package/dist/worker-matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-matching.d.ts","sourceRoot":"","sources":["../src/worker-matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGnE;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAgBvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAW5E"}

package/dist/worker-matching.js

@@ -0,0 +1,50 @@
+import { matchesType } from './filter.js';
+/**
+ * Checks if a set of task tags matches a TagMatcher.
+ *
+ * - `all`: every tag in `all` must exist in taskTags
+ * - `any`: at least one tag in `any` must exist in taskTags
+ * - `none`: none of the tags in `none` may exist in taskTags
+ * - Empty/undefined matcher matches everything
+ * - Undefined taskTags treated as empty array
+ * - Empty arrays in matcher fields are vacuous true
+ */
+export function matchesTag(taskTags, matcher) {
+    const tags = taskTags ?? [];
+    if (matcher.all !== undefined && matcher.all.length > 0) {
+        if (!matcher.all.every((tag) => tags.includes(tag)))
+            return false;
+    }
+    if (matcher.any !== undefined && matcher.any.length > 0) {
+        if (!matcher.any.some((tag) => tags.includes(tag)))
+            return false;
+    }
+    if (matcher.none !== undefined && matcher.none.length > 0) {
+        if (matcher.none.some((tag) => tags.includes(tag)))
+            return false;
+    }
+    return true;
+}
+/**
+ * Checks if a task matches a WorkerMatchRule.
+ *
+ * - If rule has `taskTypes`: task.type must match using wildcard matching
+ * - If rule has `tags`: use matchesTag
+ * - Both conditions are AND'd
+ * - Empty/no rule matches everything
+ * - Task with no `type` does not match if rule has `taskTypes`
+ */
+export function matchesWorkerRule(task, rule) {
+    if (rule.taskTypes !== undefined && rule.taskTypes.length > 0) {
+        if (task.type === undefined)
+            return false;
+        if (!matchesType(task.type, rule.taskTypes))
+            return false;
+    }
+    if (rule.tags !== undefined) {
+        if (!matchesTag(task.tags, rule.tags))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=worker-matching.js.map

package/dist/worker-matching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-matching.js","sourceRoot":"","sources":["../src/worker-matching.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,QAA8B,EAAE,OAAmB;IAC5E,MAAM,IAAI,GAAG,QAAQ,IAAI,EAAE,CAAA;IAE3B,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;IACnE,CAAC;IAED,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;IAClE,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;IAClE,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAU,EAAE,IAAqB;IACjE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAA;QACzC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,KAAK,CAAA;IAC3D,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;IACrD,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskcast/core",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "Task engine, state machine, filtering, series merging. Zero HTTP deps.",
   "repository": {
     "type": "git",