adispatchd 0.0.0-stage → 0.1.0

package/dist/persistence/lock-keys.js

@@ -0,0 +1,41 @@
+/**
+ * Lock-key semantics for the active-run uniqueness constraint
+ * `(workflow_id, lock_key)` (Spec §7, §11, §12).
+ *
+ * - Item-bound runs (trigger `source`, or `manual` with an item):
+ *   `item:<sourceItemKey>` → at most one active run per workflow and item,
+ *   also for manual starts (Spec §7: manual starts never bypass the lock).
+ * - Cron runs without item: `cron:<scheduled_for ISO>` → at most one run per
+ *   cron slot (in addition to the `cron_firings` unique key). Overlap of
+ *   different slots of the same workflow is governed by `max_concurrent`.
+ * - Manual runs without item: `manual:<runId>` → unique per run, never conflicts.
+ *
+ * Prefixes keep the namespaces disjoint (a source could be named `cron`).
+ * The retry-block / failure-counter scope is separate: the source item key,
+ * or the whole workflow for sourceless runs (see {@link blockScopeKey}).
+ */
+import { iso } from './sqlite.js';
+/** Compute the lock key for a run (see module docs). */
+export function lockKeyFor(input) {
+    if (input.sourceItemKey)
+        return `item:${input.sourceItemKey}`;
+    switch (input.triggerType) {
+        case 'source':
+            throw new TypeError('Source-triggered runs require a sourceItemKey');
+        case 'schedule':
+            if (input.scheduledFor === undefined || input.scheduledFor === null) {
+                throw new TypeError('Scheduled runs without item require scheduledFor');
+            }
+            return `cron:${iso(input.scheduledFor)}`;
+        case 'manual':
+            return `manual:${input.runId}`;
+    }
+}
+/**
+ * Internal non-null scope key for failure counters/blocks: the item key, or
+ * `''` for workflow scope (sourceless runs).
+ */
+export function blockScopeKey(itemKey) {
+    return itemKey ?? '';
+}
+//# sourceMappingURL=lock-keys.js.map

package/dist/persistence/lock-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-keys.js","sourceRoot":"","sources":["../../src/persistence/lock-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAYlC,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,KAAmB;IAC5C,IAAI,KAAK,CAAC,aAAa;QAAE,OAAO,QAAQ,KAAK,CAAC,aAAa,EAAE,CAAC;IAC9D,QAAQ,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1B,KAAK,QAAQ;YACX,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;QACvE,KAAK,UAAU;YACb,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBACpE,MAAM,IAAI,SAAS,CAAC,kDAAkD,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,QAAQ,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC3C,KAAK,QAAQ;YACX,OAAO,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAkC;IAC9D,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/persistence/notifications.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Central system notifications (Spec §18): persisted first, delivered
+ * asynchronously by WI-10; delivery attempts are stored.
+ *
+ * Since schema v2 every notification may have one delivery row per channel
+ * (`notification_deliveries`). For such notifications `deliveryState`,
+ * `attempts` and `lastError` are the aggregate over its deliveries:
+ * `pending` while any delivery is pending, else `failed` if any failed,
+ * else `delivered` (also when no channel was subscribed).
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { Clock, NotificationEventType } from '../core/index.js';
+/** Delivery state of a notification. */
+export type DeliveryState = 'pending' | 'delivered' | 'failed';
+/** A persisted notification. Payload must not contain secrets. */
+export interface NotificationRecord {
+    id: number;
+    eventType: NotificationEventType;
+    payload: Record<string, unknown>;
+    deliveryState: DeliveryState;
+    attempts: number;
+    lastError: string | null;
+    nextAttemptAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    deliveredAt: string | null;
+}
+/** Delivery of one notification to one channel (schema v2). */
+export interface NotificationDeliveryRecord {
+    id: number;
+    notificationId: number;
+    channelId: string;
+    state: DeliveryState;
+    attempts: number;
+    /** Redacted error text of the last failed attempt. */
+    lastError: string | null;
+    /** HTTP status of the last attempt, if any. */
+    lastStatus: number | null;
+    nextAttemptAt: string | null;
+    deliveredAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Outcome of one delivery attempt. */
+export type DeliveryAttemptOutcome = {
+    success: true;
+    status?: number | null;
+} | {
+    success: false;
+    error: string;
+    status?: number | null;
+    nextAttemptAt: Date | string | null;
+};
+/** Repository for `notifications`. */
+export declare class NotificationRepository {
+    private readonly db;
+    private readonly clock;
+    constructor(db: DatabaseSync, clock: Clock);
+    /** Persist a new notification in state `pending` (due immediately). */
+    create(eventType: NotificationEventType, payload: Record<string, unknown>): NotificationRecord;
+    /** Notification by ID or `null`. */
+    get(id: number): NotificationRecord | null;
+    /** Notifications, newest first, optionally filtered by state. */
+    list(options?: {
+        state?: DeliveryState;
+        limit?: number;
+        offset?: number;
+    }): NotificationRecord[];
+    /** Pending notifications due at `now` (default: clock), oldest first. */
+    listDue(now?: Date, limit?: number): NotificationRecord[];
+    /**
+     * Record one delivery attempt. Success → `delivered`. Failure → stays
+     * `pending` with `nextAttemptAt`, or `failed` when `nextAttemptAt` is `null`
+     * (retries exhausted). `error` must already be redacted.
+     */
+    recordAttempt(id: number, outcome: {
+        success: true;
+    } | {
+        success: false;
+        error: string;
+        nextAttemptAt: Date | string | null;
+    }): NotificationRecord;
+    /**
+     * Persist a notification together with one `pending` delivery per channel
+     * (one transaction). Without channels the notification is stored as
+     * `delivered` (nothing to deliver).
+     */
+    createWithDeliveries(eventType: NotificationEventType, payload: Record<string, unknown>, channelIds: readonly string[]): {
+        notification: NotificationRecord;
+        deliveries: NotificationDeliveryRecord[];
+    };
+    /** Deliveries of a notification (by channel ID). */
+    listDeliveries(notificationId: number): NotificationDeliveryRecord[];
+    /** Delivery by ID or `null`. */
+    getDelivery(id: number): NotificationDeliveryRecord | null;
+    /** Pending deliveries due at `now`, oldest first. */
+    listDueDeliveries(now: Date, limit?: number): NotificationDeliveryRecord[];
+    /** Earliest `next_attempt_at` of all pending deliveries, or `null`. */
+    nextDeliveryDue(): string | null;
+    /** Number of notifications per aggregate state. */
+    countByState(): Record<DeliveryState, number>;
+    /**
+     * Record one attempt of a delivery (success → `delivered`; failure → stays
+     * `pending` with `nextAttemptAt`, or `failed` when it is `null`) and update
+     * the notification's aggregate. `error` must already be redacted.
+     */
+    recordDeliveryAttempt(deliveryId: number, outcome: DeliveryAttemptOutcome): NotificationDeliveryRecord;
+    /** Re-queue a `failed` delivery (manual retry); returns `null` if it is not `failed`. */
+    requeueDelivery(deliveryId: number): NotificationDeliveryRecord | null;
+    /** Recompute the aggregate columns of a notification from its deliveries. */
+    private refreshAggregate;
+    private require;
+}

package/dist/persistence/notifications.js

@@ -0,0 +1,213 @@
+import { NotFoundError } from './errors.js';
+import { all, get, iso, run, str, transaction } from './sqlite.js';
+/** Repository for `notifications`. */
+export class NotificationRepository {
+    db;
+    clock;
+    constructor(db, clock) {
+        this.db = db;
+        this.clock = clock;
+    }
+    /** Persist a new notification in state `pending` (due immediately). */
+    create(eventType, payload) {
+        const now = this.clock.now().toISOString();
+        const res = run(this.db, `INSERT INTO notifications (event_type, payload_json, delivery_state, attempts, next_attempt_at, created_at, updated_at)
+       VALUES (?, ?, 'pending', 0, ?, ?, ?)`, [eventType, JSON.stringify(payload), now, now, now]);
+        return this.require(res.lastInsertRowid);
+    }
+    /** Notification by ID or `null`. */
+    get(id) {
+        const row = get(this.db, 'SELECT * FROM notifications WHERE id = ?', [id]);
+        return row ? toNotification(row) : null;
+    }
+    /** Notifications, newest first, optionally filtered by state. */
+    list(options = {}) {
+        const params = [];
+        let sql = 'SELECT * FROM notifications';
+        if (options.state !== undefined) {
+            sql += ' WHERE delivery_state = ?';
+            params.push(options.state);
+        }
+        sql += ' ORDER BY created_at DESC, id DESC LIMIT ? OFFSET ?';
+        params.push(options.limit ?? 100, options.offset ?? 0);
+        return all(this.db, sql, params).map(toNotification);
+    }
+    /** Pending notifications due at `now` (default: clock), oldest first. */
+    listDue(now, limit = 100) {
+        return all(this.db, `SELECT * FROM notifications WHERE delivery_state = 'pending' AND (next_attempt_at IS NULL OR next_attempt_at <= ?)
+       ORDER BY created_at ASC, id ASC LIMIT ?`, [iso(now ?? this.clock.now()), limit]).map(toNotification);
+    }
+    /**
+     * Record one delivery attempt. Success → `delivered`. Failure → stays
+     * `pending` with `nextAttemptAt`, or `failed` when `nextAttemptAt` is `null`
+     * (retries exhausted). `error` must already be redacted.
+     */
+    recordAttempt(id, outcome) {
+        return transaction(this.db, () => {
+            this.require(id);
+            const now = this.clock.now().toISOString();
+            if (outcome.success) {
+                run(this.db, `UPDATE notifications SET delivery_state = 'delivered', attempts = attempts + 1, delivered_at = ?, next_attempt_at = NULL,
+             updated_at = ? WHERE id = ?`, [now, now, id]);
+            }
+            else {
+                const next = outcome.nextAttemptAt === null ? null : iso(outcome.nextAttemptAt);
+                run(this.db, `UPDATE notifications SET delivery_state = ?, attempts = attempts + 1, last_error = ?, next_attempt_at = ?, updated_at = ?
+           WHERE id = ?`, [next === null ? 'failed' : 'pending', outcome.error, next, now, id]);
+            }
+            return this.require(id);
+        });
+    }
+    /**
+     * Persist a notification together with one `pending` delivery per channel
+     * (one transaction). Without channels the notification is stored as
+     * `delivered` (nothing to deliver).
+     */
+    createWithDeliveries(eventType, payload, channelIds) {
+        return transaction(this.db, () => {
+            const created = this.create(eventType, payload);
+            const now = this.clock.now().toISOString();
+            for (const channelId of new Set(channelIds)) {
+                run(this.db, `INSERT INTO notification_deliveries (notification_id, channel_id, state, attempts, next_attempt_at, created_at, updated_at)
+           VALUES (?, ?, 'pending', 0, ?, ?, ?)`, [created.id, channelId, now, now, now]);
+            }
+            this.refreshAggregate(created.id);
+            return { notification: this.require(created.id), deliveries: this.listDeliveries(created.id) };
+        });
+    }
+    /** Deliveries of a notification (by channel ID). */
+    listDeliveries(notificationId) {
+        return all(this.db, 'SELECT * FROM notification_deliveries WHERE notification_id = ? ORDER BY channel_id ASC, id ASC', [
+            notificationId,
+        ]).map(toDelivery);
+    }
+    /** Delivery by ID or `null`. */
+    getDelivery(id) {
+        const row = get(this.db, 'SELECT * FROM notification_deliveries WHERE id = ?', [id]);
+        return row ? toDelivery(row) : null;
+    }
+    /** Pending deliveries due at `now`, oldest first. */
+    listDueDeliveries(now, limit = 100) {
+        return all(this.db, `SELECT * FROM notification_deliveries WHERE state = 'pending' AND (next_attempt_at IS NULL OR next_attempt_at <= ?)
+       ORDER BY next_attempt_at ASC, id ASC LIMIT ?`, [iso(now), limit]).map(toDelivery);
+    }
+    /** Earliest `next_attempt_at` of all pending deliveries, or `null`. */
+    nextDeliveryDue() {
+        const row = get(this.db, `SELECT MIN(next_attempt_at) AS t FROM notification_deliveries WHERE state = 'pending'`);
+        return str(row?.t);
+    }
+    /** Number of notifications per aggregate state. */
+    countByState() {
+        const counts = { pending: 0, delivered: 0, failed: 0 };
+        for (const row of all(this.db, 'SELECT delivery_state AS s, COUNT(*) AS n FROM notifications GROUP BY delivery_state')) {
+            counts[row.s] = Number(row.n);
+        }
+        return counts;
+    }
+    /**
+     * Record one attempt of a delivery (success → `delivered`; failure → stays
+     * `pending` with `nextAttemptAt`, or `failed` when it is `null`) and update
+     * the notification's aggregate. `error` must already be redacted.
+     */
+    recordDeliveryAttempt(deliveryId, outcome) {
+        return transaction(this.db, () => {
+            const delivery = this.getDelivery(deliveryId);
+            if (!delivery)
+                throw new NotFoundError('notification_delivery', deliveryId);
+            const now = this.clock.now().toISOString();
+            const status = outcome.status ?? null;
+            if (outcome.success) {
+                run(this.db, `UPDATE notification_deliveries SET state = 'delivered', attempts = attempts + 1, last_status = ?, delivered_at = ?,
+             next_attempt_at = NULL, updated_at = ? WHERE id = ?`, [status, now, now, deliveryId]);
+            }
+            else {
+                const next = outcome.nextAttemptAt === null ? null : iso(outcome.nextAttemptAt);
+                run(this.db, `UPDATE notification_deliveries SET state = ?, attempts = attempts + 1, last_error = ?, last_status = ?, next_attempt_at = ?,
+             updated_at = ? WHERE id = ?`, [next === null ? 'failed' : 'pending', outcome.error, status, next, now, deliveryId]);
+            }
+            this.refreshAggregate(delivery.notificationId);
+            return this.getDelivery(deliveryId);
+        });
+    }
+    /** Re-queue a `failed` delivery (manual retry); returns `null` if it is not `failed`. */
+    requeueDelivery(deliveryId) {
+        return transaction(this.db, () => {
+            const delivery = this.getDelivery(deliveryId);
+            if (!delivery)
+                throw new NotFoundError('notification_delivery', deliveryId);
+            if (delivery.state !== 'failed')
+                return null;
+            const now = this.clock.now().toISOString();
+            run(this.db, `UPDATE notification_deliveries SET state = 'pending', next_attempt_at = ?, updated_at = ? WHERE id = ?`, [
+                now,
+                now,
+                deliveryId,
+            ]);
+            this.refreshAggregate(delivery.notificationId);
+            return this.getDelivery(deliveryId);
+        });
+    }
+    /** Recompute the aggregate columns of a notification from its deliveries. */
+    refreshAggregate(notificationId) {
+        const deliveries = this.listDeliveries(notificationId);
+        const now = this.clock.now().toISOString();
+        const state = deliveries.some((d) => d.state === 'pending')
+            ? 'pending'
+            : deliveries.some((d) => d.state === 'failed')
+                ? 'failed'
+                : 'delivered';
+        const attempts = deliveries.reduce((sum, d) => sum + d.attempts, 0);
+        const lastError = [...deliveries]
+            .filter((d) => d.lastError !== null && d.state !== 'delivered')
+            .sort((a, b) => (a.updatedAt < b.updatedAt ? 1 : -1))[0]?.lastError ?? null;
+        const nextAttempt = deliveries
+            .filter((d) => d.state === 'pending' && d.nextAttemptAt !== null)
+            .map((d) => d.nextAttemptAt)
+            .sort()[0] ?? null;
+        const deliveredAt = state === 'delivered'
+            ? (deliveries
+                .map((d) => d.deliveredAt)
+                .filter((t) => t !== null)
+                .sort()
+                .at(-1) ?? null)
+            : null;
+        run(this.db, `UPDATE notifications SET delivery_state = ?, attempts = ?, last_error = ?, next_attempt_at = ?, delivered_at = ?, updated_at = ?
+       WHERE id = ?`, [state, attempts, lastError, nextAttempt, deliveredAt, now, notificationId]);
+    }
+    require(id) {
+        const n = this.get(id);
+        if (!n)
+            throw new NotFoundError('notification', id);
+        return n;
+    }
+}
+function toDelivery(row) {
+    return {
+        id: Number(row.id),
+        notificationId: Number(row.notification_id),
+        channelId: String(row.channel_id),
+        state: row.state,
+        attempts: Number(row.attempts),
+        lastError: str(row.last_error),
+        lastStatus: row.last_status === null || row.last_status === undefined ? null : Number(row.last_status),
+        nextAttemptAt: str(row.next_attempt_at),
+        deliveredAt: str(row.delivered_at),
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+    };
+}
+function toNotification(row) {
+    return {
+        id: Number(row.id),
+        eventType: row.event_type,
+        payload: JSON.parse(String(row.payload_json)),
+        deliveryState: row.delivery_state,
+        attempts: Number(row.attempts),
+        lastError: str(row.last_error),
+        nextAttemptAt: str(row.next_attempt_at),
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+        deliveredAt: str(row.delivered_at),
+    };
+}
+//# sourceMappingURL=notifications.js.map

package/dist/persistence/notifications.js.map

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

package/dist/persistence/persistence.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Composition root of the persistence component.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import { type Clock } from '../core/index.js';
+import { ActionRepository } from './actions.js';
+import { BlockRepository } from './blocks.js';
+import { CronFiringRepository } from './cron-firings.js';
+import { type MigrationResult, type OpenDatabaseOptions } from './database.js';
+import { EventRepository } from './events.js';
+import { NotificationRepository } from './notifications.js';
+import { RetentionRepository } from './retention.js';
+import { RunRepository } from './runs.js';
+/** All repositories over one connection. */
+export interface Repositories {
+    runs: RunRepository;
+    events: EventRepository;
+    actions: ActionRepository;
+    blocks: BlockRepository;
+    notifications: NotificationRepository;
+    cronFirings: CronFiringRepository;
+    retention: RetentionRepository;
+    /** Run `fn` in one transaction (nested repository calls join it via savepoints). */
+    transaction<T>(fn: () => T): T;
+    /**
+     * Run `cb` after the outermost open transaction commits (immediately if none);
+     * dropped on rollback. Publish to the in-process event bus / SSE only from here.
+     */
+    afterCommit(cb: () => void): void;
+}
+/** Create repositories over an already opened and migrated connection. */
+export declare function createRepositories(db: DatabaseSync, options?: {
+    clock?: Clock;
+}): Repositories;
+/** Opened database plus repositories. */
+export interface Persistence extends Repositories {
+    db: DatabaseSync;
+    path: string;
+    migration: MigrationResult;
+    close(): void;
+}
+/**
+ * Open `<dataDir>/adispatchd.sqlite`, migrate and create all repositories.
+ * Acquire the instance lock ({@link acquireInstanceLock}) before calling this.
+ */
+export declare function openPersistence(dataDir: string, options?: OpenDatabaseOptions): Persistence;

package/dist/persistence/persistence.js

@@ -0,0 +1,42 @@
+import { systemClock } from '../core/index.js';
+import { ActionRepository } from './actions.js';
+import { BlockRepository } from './blocks.js';
+import { CronFiringRepository } from './cron-firings.js';
+import { openDatabase } from './database.js';
+import { EventRepository } from './events.js';
+import { NotificationRepository } from './notifications.js';
+import { RetentionRepository } from './retention.js';
+import { RunRepository } from './runs.js';
+import { afterCommit, transaction } from './sqlite.js';
+/** Create repositories over an already opened and migrated connection. */
+export function createRepositories(db, options = {}) {
+    const clock = options.clock ?? systemClock;
+    const events = new EventRepository(db, clock);
+    const blocks = new BlockRepository(db, clock);
+    return {
+        runs: new RunRepository(db, clock, events, blocks),
+        events,
+        actions: new ActionRepository(db, clock),
+        blocks,
+        notifications: new NotificationRepository(db, clock),
+        cronFirings: new CronFiringRepository(db, clock),
+        retention: new RetentionRepository(db),
+        transaction: (fn) => transaction(db, fn),
+        afterCommit: (cb) => afterCommit(db, cb),
+    };
+}
+/**
+ * Open `<dataDir>/adispatchd.sqlite`, migrate and create all repositories.
+ * Acquire the instance lock ({@link acquireInstanceLock}) before calling this.
+ */
+export function openPersistence(dataDir, options = {}) {
+    const opened = openDatabase(dataDir, options);
+    return {
+        ...createRepositories(opened.db, options.clock ? { clock: options.clock } : {}),
+        db: opened.db,
+        path: opened.path,
+        migration: opened.migration,
+        close: opened.close,
+    };
+}
+//# sourceMappingURL=persistence.js.map

package/dist/persistence/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.js","sourceRoot":"","sources":["../../src/persistence/persistence.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAc,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAkD,MAAM,eAAe,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoBvD,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAAC,EAAgB,EAAE,OAAO,GAAsB,EAAE;IAClF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;IAC3C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO;QACL,IAAI,EAAE,IAAI,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;QAClD,MAAM;QACN,OAAO,EAAE,IAAI,gBAAgB,CAAC,EAAE,EAAE,KAAK,CAAC;QACxC,MAAM;QACN,aAAa,EAAE,IAAI,sBAAsB,CAAC,EAAE,EAAE,KAAK,CAAC;QACpD,WAAW,EAAE,IAAI,oBAAoB,CAAC,EAAE,EAAE,KAAK,CAAC;QAChD,SAAS,EAAE,IAAI,mBAAmB,CAAC,EAAE,CAAC;QACtC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC;QACxC,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,CAAC;KACzC,CAAC;AACJ,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,OAAO,GAAwB,EAAE;IAChF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,OAAO;QACL,GAAG,kBAAkB,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC;AACJ,CAAC"}

package/dist/persistence/retention.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Retention data access (Spec §21). Only queries and row deletion; the
+ * periodic job and file/workspace deletion belong to WI-10.
+ *
+ * Protection rules – a run is never a candidate (and never deleted) if
+ * - it is not terminal (active runs hold locks / may be recovered),
+ * - its lifecycle chain is unfinished: `lifecycle_status` is `pending`,
+ *   `running` or `failed`, or any journaled action is `pending`/`running`,
+ * - an active (uncleared) retry block exists for its workflow and block scope.
+ */
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * Run retention categories (Spec §5.1, §21): `successful` = `completed` + `success`;
+ * `blocked` = technical failures counted into a retry block (the block's
+ * counting period, `retention.blocked_runs`); `failed` = every other terminal
+ * run (business failure, technical failure, cancelled).
+ */
+export type RunRetentionCategory = 'successful' | 'failed' | 'blocked';
+/** A run eligible for deletion. */
+export interface RunRetentionCandidate {
+    runId: string;
+    workflowId: string;
+    finishedAt: string;
+    /** Workspace to delete (caller must check it lies within `workspace.base_dir`). */
+    workspacePath: string | null;
+}
+/** Retention queries and deletions. */
+export declare class RetentionRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    /** Runs of a category finished before `olderThan`, oldest first, excluding protected runs. */
+    runCandidates(category: RunRetentionCategory, olderThan: Date | string, limit?: number): RunRetentionCandidate[];
+    /** True if the run exists and is protected by one of the rules above. */
+    isRunProtected(runId: string): boolean;
+    /**
+     * Delete a run row incl. events, actions and attempts (cascade). Re-checks
+     * protection in the same transaction; returns `false` if protected or missing.
+     */
+    deleteRun(runId: string): boolean;
+    /** Delete cleared blocks cleared before `olderThan`. Active blocks are never deleted. Returns count. */
+    deleteClearedBlocks(olderThan: Date | string): number;
+    /** Delete delivered/failed notifications created before `olderThan`. Pending ones are kept. Returns count. */
+    deleteNotifications(olderThan: Date | string): number;
+    /** Delete cron firings recorded before `olderThan`, keeping each workflow's latest one. Returns count. */
+    deleteCronFirings(olderThan: Date | string): number;
+}

package/dist/persistence/retention.js

@@ -0,0 +1,68 @@
+import { all, get, iso, run, str, transaction } from './sqlite.js';
+const PROTECTION_SQL = `
+  r.status IN ('completed','crashed','start_error','timed_out','cancelled')
+  AND (r.lifecycle_status IS NULL OR r.lifecycle_status = 'succeeded')
+  AND NOT EXISTS (SELECT 1 FROM run_actions a WHERE a.run_id = r.id AND a.status IN ('pending','running'))
+  AND NOT EXISTS (SELECT 1 FROM blocks b WHERE b.cleared_at IS NULL AND b.workflow_id = r.workflow_id
+                    AND COALESCE(b.source_item_key, '') = COALESCE(r.source_item_key, ''))
+  AND NOT EXISTS (SELECT 1 FROM locks l WHERE l.run_id = r.id)`;
+/** Run belongs to the counting period of a (cleared or active) retry block. */
+const BLOCKED_SQL = `(r.counted_technical_failure = 1 AND EXISTS (SELECT 1 FROM blocks b2 WHERE b2.workflow_id = r.workflow_id
+    AND COALESCE(b2.source_item_key, '') = COALESCE(r.source_item_key, '') AND b2.generation = r.block_generation))`;
+const CATEGORY_SQL = {
+    successful: `(r.status = 'completed' AND r.business_result = 'success')`,
+    failed: `(NOT (r.status = 'completed' AND r.business_result = 'success') AND NOT ${BLOCKED_SQL})`,
+    blocked: BLOCKED_SQL,
+};
+/** Retention queries and deletions. */
+export class RetentionRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Runs of a category finished before `olderThan`, oldest first, excluding protected runs. */
+    runCandidates(category, olderThan, limit = 500) {
+        return all(this.db, `SELECT r.id, r.workflow_id, r.finished_at, r.workspace_path FROM runs r
+       WHERE ${CATEGORY_SQL[category]} AND r.finished_at IS NOT NULL AND r.finished_at < ? AND ${PROTECTION_SQL}
+       ORDER BY r.finished_at ASC, r.id ASC LIMIT ?`, [iso(olderThan), limit]).map((row) => ({
+            runId: String(row.id),
+            workflowId: String(row.workflow_id),
+            finishedAt: String(row.finished_at),
+            workspacePath: str(row.workspace_path),
+        }));
+    }
+    /** True if the run exists and is protected by one of the rules above. */
+    isRunProtected(runId) {
+        const exists = get(this.db, 'SELECT 1 FROM runs WHERE id = ?', [runId]);
+        if (!exists)
+            return false;
+        return !get(this.db, `SELECT 1 FROM runs r WHERE r.id = ? AND ${PROTECTION_SQL}`, [runId]);
+    }
+    /**
+     * Delete a run row incl. events, actions and attempts (cascade). Re-checks
+     * protection in the same transaction; returns `false` if protected or missing.
+     */
+    deleteRun(runId) {
+        return transaction(this.db, () => {
+            if (!get(this.db, `SELECT 1 FROM runs r WHERE r.id = ? AND ${PROTECTION_SQL}`, [runId]))
+                return false;
+            return run(this.db, 'DELETE FROM runs WHERE id = ?', [runId]).changes === 1;
+        });
+    }
+    /** Delete cleared blocks cleared before `olderThan`. Active blocks are never deleted. Returns count. */
+    deleteClearedBlocks(olderThan) {
+        return run(this.db, 'DELETE FROM blocks WHERE cleared_at IS NOT NULL AND cleared_at < ?', [iso(olderThan)]).changes;
+    }
+    /** Delete delivered/failed notifications created before `olderThan`. Pending ones are kept. Returns count. */
+    deleteNotifications(olderThan) {
+        return run(this.db, `DELETE FROM notifications WHERE delivery_state <> 'pending' AND created_at < ?`, [iso(olderThan)])
+            .changes;
+    }
+    /** Delete cron firings recorded before `olderThan`, keeping each workflow's latest one. Returns count. */
+    deleteCronFirings(olderThan) {
+        const params = [iso(olderThan)];
+        return run(this.db, `DELETE FROM cron_firings WHERE recorded_at < ?
+         AND scheduled_for < (SELECT MAX(c2.scheduled_for) FROM cron_firings c2 WHERE c2.workflow_id = cron_firings.workflow_id)`, params).changes;
+    }
+}
+//# sourceMappingURL=retention.js.map

package/dist/persistence/retention.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.js","sourceRoot":"","sources":["../../src/persistence/retention.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AAmB1F,MAAM,cAAc,GAAG;;;;;;+DAMwC,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,WAAW,GAAG;oHACgG,CAAC;AAErH,MAAM,YAAY,GAAyC;IACzD,UAAU,EAAE,4DAA4D;IACxE,MAAM,EAAE,2EAA2E,WAAW,GAAG;IACjG,OAAO,EAAE,WAAW;CACrB,CAAC;AAEF,uCAAuC;AACvC,MAAM,OAAO,mBAAmB;IACD,EAAE;IAA/B,YAA6B,EAAgB;kBAAhB,EAAE;IAAiB,CAAC;IAEjD,8FAA8F;IAC9F,aAAa,CAAC,QAA8B,EAAE,SAAwB,EAAE,KAAK,GAAG,GAAG;QACjF,OAAO,GAAG,CACR,IAAI,CAAC,EAAE,EACP;eACS,YAAY,CAAC,QAAQ,CAAC,4DAA4D,cAAc;oDAC3D,EAC9C,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CACxB,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;YACnB,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;YACnC,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;YACnC,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC;SACvC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,yEAAyE;IACzE,cAAc,CAAC,KAAa;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,iCAAiC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,2CAA2C,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE;YAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,2CAA2C,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtG,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,+BAA+B,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,wGAAwG;IACxG,mBAAmB,CAAC,SAAwB;QAC1C,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,oEAAoE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACtH,CAAC;IAED,8GAA8G;IAC9G,mBAAmB,CAAC,SAAwB;QAC1C,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,gFAAgF,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;aACpH,OAAO,CAAC;IACb,CAAC;IAED,0GAA0G;IAC1G,iBAAiB,CAAC,SAAwB;QACxC,MAAM,MAAM,GAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACxC,OAAO,GAAG,CACR,IAAI,CAAC,EAAE,EACP;iIAC2H,EAC3H,MAAM,CACP,CAAC,OAAO,CAAC;IACZ,CAAC;CACF"}