@byline/db-mysql 4.14.0 → 4.15.0

package/dist/database/schema/index.d.ts

@@ -485,6 +485,319 @@ export declare const documentVersions: import("drizzle-orm/mysql-core").MySqlTab
     };
     dialect: 'mysql';
 }>;
+export declare const documentPublishSchedules: import("drizzle-orm/mysql-core").MySqlTableWithColumns<{
+    name: "byline_document_publish_schedules";
+    schema: undefined;
+    columns: {
+        document_id: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "document_id";
+            tableName: "byline_document_publish_schedules";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        collection_id: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "collection_id";
+            tableName: "byline_document_publish_schedules";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        target_version_id: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "target_version_id";
+            tableName: "byline_document_publish_schedules";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        publish_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "publish_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        state: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "state";
+            tableName: "byline_document_publish_schedules";
+            dataType: "string";
+            columnType: "MySqlVarChar";
+            data: string;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        suspended_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "suspended_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        suspended_reason: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "suspended_reason";
+            tableName: "byline_document_publish_schedules";
+            dataType: "string";
+            columnType: "MySqlVarChar";
+            data: string;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        scheduled_by: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "scheduled_by";
+            tableName: "byline_document_publish_schedules";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_authorized_by: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_authorized_by";
+            tableName: "byline_document_publish_schedules";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_authorized_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_authorized_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        scheduled_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "scheduled_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "updated_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        execution_token: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "execution_token";
+            tableName: "byline_document_publish_schedules";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        execution_expires_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "execution_expires_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_attempt_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_attempt_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        next_attempt_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "next_attempt_at";
+            tableName: "byline_document_publish_schedules";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        attempt_count: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "attempt_count";
+            tableName: "byline_document_publish_schedules";
+            dataType: "number";
+            columnType: "MySqlInt";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_error: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_error";
+            tableName: "byline_document_publish_schedules";
+            dataType: "string";
+            columnType: "MySqlText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'mysql';
+}>;
 export declare const documentPaths: import("drizzle-orm/mysql-core").MySqlTableWithColumns<{
     name: "byline_document_paths";
     schema: undefined;
@@ -3452,4 +3765,266 @@ export declare const auditLog: import("drizzle-orm/mysql-core").MySqlTableWithCo
     };
     dialect: 'mysql';
 }>;
+export declare const recurringTasks: import("drizzle-orm/mysql-core").MySqlTableWithColumns<{
+    name: "byline_recurring_tasks";
+    schema: undefined;
+    columns: {
+        created_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: string;
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        updated_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: string;
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        name: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "name";
+            tableName: "byline_recurring_tasks";
+            dataType: "string";
+            columnType: "MySqlVarChar";
+            data: string;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        interval_ms: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "interval_ms";
+            tableName: "byline_recurring_tasks";
+            dataType: "number";
+            columnType: "MySqlBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        next_run_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "next_run_at";
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lease_token: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "lease_token";
+            tableName: "byline_recurring_tasks";
+            dataType: "custom";
+            columnType: "MySqlCustomColumn";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lease_owner: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "lease_owner";
+            tableName: "byline_recurring_tasks";
+            dataType: "string";
+            columnType: "MySqlVarChar";
+            data: string;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        lease_expires_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "lease_expires_at";
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_started_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_started_at";
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_succeeded_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_succeeded_at";
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_failed_at: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_failed_at";
+            tableName: "byline_recurring_tasks";
+            dataType: "date";
+            columnType: "MySqlDateTime";
+            data: Date;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_duration_ms: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_duration_ms";
+            tableName: "byline_recurring_tasks";
+            dataType: "number";
+            columnType: "MySqlBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        consecutive_failures: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "consecutive_failures";
+            tableName: "byline_recurring_tasks";
+            dataType: "number";
+            columnType: "MySqlInt";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_status: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_status";
+            tableName: "byline_recurring_tasks";
+            dataType: "string";
+            columnType: "MySqlVarChar";
+            data: string;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_error: import("drizzle-orm/mysql-core").MySqlColumn<{
+            name: "last_error";
+            tableName: "byline_recurring_tasks";
+            dataType: "string";
+            columnType: "MySqlText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: 'mysql';
+}>;
 export { adminPermissions, adminPermissionsRelations, adminRefreshTokens, adminRefreshTokensRelations, adminRoleAdminUser, adminRoleAdminUserRelations, adminRoles, adminRolesRelations, adminUserPreferences, adminUsers, adminUsersRelations, } from './auth.js';

package/dist/database/schema/index.js

@@ -6,7 +6,7 @@
  * Copyright (c) Infonomic Company Limited
  */
 import { eq, relations, sql } from 'drizzle-orm';
-import { bigint, boolean, date, datetime, decimal, float, foreignKey, index, int, json, mysqlTable, mysqlView, primaryKey, text, time, unique, varchar, } from 'drizzle-orm/mysql-core';
+import { bigint, boolean, check, date, datetime, decimal, float, foreignKey, index, int, json, mysqlTable, mysqlView, primaryKey, text, time, unique, varchar, } from 'drizzle-orm/mysql-core';
 import { createdAt, timestamps, uuidChar, varcharByteSorted, varcharCaseSensitive, } from './common.js';
 // Every foreign key below is declared with the table-level `foreignKey()`
 // builder and an explicit, short `fk_<table>_<column>` name, rather than
@@ -115,6 +115,55 @@ export const documentVersions = mysqlTable('byline_document_versions', {
     // Ensure logical document belongs to only one collection
     index('idx_documents_document_collection').on(table.document_id, table.collection_id),
 ]);
+// Scheduled publication — one active intent row per logical document.
+// This is document lifecycle metadata, not authored/versioned content. The
+// target version is pinned until a later content write suspends the row for
+// explicit re-confirmation. See specs/2026-08-22-scheduled-publish.md.
+export const documentPublishSchedules = mysqlTable('byline_document_publish_schedules', {
+    document_id: uuidChar('document_id').primaryKey(),
+    collection_id: uuidChar('collection_id').notNull(),
+    target_version_id: uuidChar('target_version_id').notNull(),
+    publish_at: datetime('publish_at', { fsp: 6 }).notNull(),
+    state: varchar('state', { length: 32 }).notNull().default('armed'),
+    suspended_at: datetime('suspended_at', { fsp: 6 }),
+    suspended_reason: varchar('suspended_reason', { length: 32 }),
+    // Historical and current authorizers are deliberately not foreign keys:
+    // deleting an admin account must not revoke an already-authorized schedule.
+    scheduled_by: uuidChar('scheduled_by'),
+    last_authorized_by: uuidChar('last_authorized_by'),
+    last_authorized_at: datetime('last_authorized_at', { fsp: 6 }).notNull(),
+    scheduled_at: datetime('scheduled_at', { fsp: 6 }).notNull().default(sql `CURRENT_TIMESTAMP(6)`),
+    updated_at: datetime('updated_at', { fsp: 6 }).notNull().default(sql `CURRENT_TIMESTAMP(6)`),
+    execution_token: uuidChar('execution_token'),
+    execution_expires_at: datetime('execution_expires_at', { fsp: 6 }),
+    last_attempt_at: datetime('last_attempt_at', { fsp: 6 }),
+    next_attempt_at: datetime('next_attempt_at', { fsp: 6 }).notNull(),
+    attempt_count: int('attempt_count').notNull().default(0),
+    // Sanitized by the storage command and capped at 2 KiB; never stores a
+    // stack or document content.
+    last_error: text('last_error'),
+}, (table) => [
+    foreignKey({
+        name: 'fk_publish_schedules_document',
+        columns: [table.document_id],
+        foreignColumns: [documents.id],
+    }).onDelete('cascade'),
+    foreignKey({
+        name: 'fk_publish_schedules_collection',
+        columns: [table.collection_id],
+        foreignColumns: [collections.id],
+    }).onDelete('cascade'),
+    foreignKey({
+        name: 'fk_publish_schedules_target_version',
+        columns: [table.target_version_id],
+        foreignColumns: [documentVersions.id],
+    }).onDelete('cascade'),
+    check('check_publish_schedules_state', sql `${table.state} IN ('armed', 'needs_reconfirm')`),
+    check('check_publish_schedules_suspended_reason', sql `${table.suspended_reason} IS NULL OR ${table.suspended_reason} = 'content_edited'`),
+    // MySQL has no partial indexes, so state is the leading discriminator.
+    index('idx_document_publish_schedules_due').on(table.state, table.next_attempt_at, table.publish_at),
+    index('idx_document_publish_schedules_execution_expiry').on(table.execution_expires_at),
+]);
 // Document paths — one row per (logical document, content locale).
 // Promotes `path` out of the version row so per-collection uniqueness can
 // be enforced at the DB layer without colliding with the sticky
@@ -894,6 +943,37 @@ export const auditLog = mysqlTable('byline_audit_log', {
     index('idx_audit_log_action').on(table.action, table.id),
 ]);
 // ---------------------------------------------------------------------------
+// Recurring-task scheduler — byline_recurring_tasks
+// ---------------------------------------------------------------------------
+// Recurring-task scheduler (specs/2026-08-22-scheduler.md).
+// Code-registered definitions are authoritative; rows for definitions removed
+// from code are retained as dormant history and never executed.
+export const recurringTasks = mysqlTable('byline_recurring_tasks', {
+    name: varchar('name', { length: 255 }).primaryKey(),
+    // bigint: MySQL INT tops out at ~24.9 days in milliseconds, and a 30-day
+    // interval is a legitimate configuration. `mode: 'number'` is safe because
+    // boot-time validation guarantees every millisecond value is a JS safe integer.
+    interval_ms: bigint('interval_ms', { mode: 'number' }).notNull(),
+    next_run_at: datetime('next_run_at', { fsp: 6 }).notNull(),
+    // A token unique to one claim — not a stable machine id. Every health and
+    // schedule write is conditional on it, so a slow runner whose lease expired
+    // cannot overwrite a newer run.
+    lease_token: uuidChar('lease_token'),
+    // Bounded, non-secret diagnostic label (machine id + pid). Correctness never
+    // depends on owner uniqueness.
+    lease_owner: varchar('lease_owner', { length: 255 }),
+    lease_expires_at: datetime('lease_expires_at', { fsp: 6 }),
+    last_started_at: datetime('last_started_at', { fsp: 6 }),
+    last_succeeded_at: datetime('last_succeeded_at', { fsp: 6 }),
+    last_failed_at: datetime('last_failed_at', { fsp: 6 }),
+    last_duration_ms: bigint('last_duration_ms', { mode: 'number' }),
+    consecutive_failures: int('consecutive_failures').notNull().default(0),
+    last_status: varchar('last_status', { length: 32 }).notNull().default('never_run'),
+    // Sanitized message, capped at 2 KiB by the store. Full stacks go to the logger.
+    last_error: text('last_error'),
+    ...timestamps,
+});
+// ---------------------------------------------------------------------------
 // Auth schema — byline_admin_users, byline_admin_roles, etc.
 // See ./auth.ts for definitions and rationale.
 // ---------------------------------------------------------------------------