pixivflow 2.12.3 → 2.14.0

package/dist/storage/repositories/DeliveryRepository.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryRepository = void 0;
+const BaseRepository_1 = require("./BaseRepository");
+/**
+ * The delivery ledger. Answers "has this work actually been CONFIRMED delivered
+ * to this target?" — distinct from the downloads table ("was the file cached
+ * locally?"). downloaded != delivered.
+ *
+ * Dedup scope is (delivery_target, work_type, pixiv_id): bot1 having posted a
+ * work does not forbid bot2 posting it.
+ */
+class DeliveryRepository extends BaseRepository_1.BaseRepository {
+    /** Insert a pending intent. No-op if the idempotency key already exists. */
+    insertIntent(input) {
+        const info = this.db
+            .prepare(`INSERT INTO deliveries
+           (id, delivery_target, work_type, pixiv_id, slot_id, target_id, idempotency_key, status)
+         VALUES
+           (@id, @deliveryTarget, @workType, @pixivId, @slotId, @targetId, @idempotencyKey, 'pending')
+         ON CONFLICT(idempotency_key) DO NOTHING`)
+            .run({
+            id: input.id,
+            deliveryTarget: input.deliveryTarget,
+            workType: input.workType,
+            pixivId: input.pixivId,
+            slotId: input.slotId ?? null,
+            targetId: input.targetId ?? null,
+            idempotencyKey: input.idempotencyKey,
+        });
+        const created = info.changes > 0;
+        return { row: created ? this.getById(input.id) : this.getByIdempotencyKey(input.idempotencyKey), created };
+    }
+    getById(id) {
+        const row = this.db.prepare(`SELECT * FROM deliveries WHERE id = ?`).get(id);
+        return row ? this.toRow(row) : null;
+    }
+    getByIdempotencyKey(key) {
+        const row = this.db.prepare(`SELECT * FROM deliveries WHERE idempotency_key = ?`).get(key);
+        return row ? this.toRow(row) : null;
+    }
+    /**
+     * True when this exact work is already CONFIRMED (delivered, or an attested
+     * historical duplicate) for this target. Pending/failed intents do not block
+     * selection — they are retried, not treated as a delivered fact.
+     */
+    isDelivered(deliveryTarget, workType, pixivId) {
+        const row = this.db
+            .prepare(`SELECT 1 FROM deliveries
+         WHERE delivery_target = ? AND work_type = ? AND pixiv_id = ?
+           AND status IN ('delivered','duplicate')
+         LIMIT 1`)
+            .get(deliveryTarget, workType, String(pixivId));
+        return Boolean(row);
+    }
+    /** Batch form for candidate-pipeline pre-lock dedupe. */
+    deliveredIds(deliveryTarget, workType, pixivIds) {
+        const out = new Set();
+        if (pixivIds.length === 0)
+            return out;
+        const CHUNK = 400;
+        for (let i = 0; i < pixivIds.length; i += CHUNK) {
+            const slice = pixivIds.slice(i, i + CHUNK);
+            const placeholders = slice.map(() => '?').join(',');
+            const rows = this.db
+                .prepare(`SELECT DISTINCT pixiv_id FROM deliveries
+           WHERE delivery_target = ? AND work_type = ? AND status IN ('delivered','duplicate')
+             AND pixiv_id IN (${placeholders})`)
+                .all(deliveryTarget, workType, ...slice);
+            for (const r of rows)
+                out.add(r.pixiv_id);
+        }
+        return out;
+    }
+    recordAck(id, ack) {
+        const terminal = ack.status === 'delivered' || ack.status === 'duplicate' || ack.status === 'failed';
+        const sets = [
+            'status = @status',
+            'remote_id = COALESCE(@remoteId, remote_id)',
+            'remote_status = @remoteStatus',
+            'reuse_reason = @reuseReason',
+            'last_error = @error',
+            'attempts = attempts + 1',
+            'updated_at = CURRENT_TIMESTAMP',
+        ];
+        if (terminal)
+            sets.push(`delivered_at = COALESCE(delivered_at, CASE WHEN @status IN ('delivered','duplicate') THEN CURRENT_TIMESTAMP ELSE NULL END)`);
+        this.db
+            .prepare(`UPDATE deliveries SET ${sets.join(', ')} WHERE id = @id`)
+            .run({
+            id,
+            status: ack.status,
+            remoteId: ack.remoteId ?? null,
+            remoteStatus: ack.remoteStatus ?? null,
+            reuseReason: ack.reuseReason ?? null,
+            error: ack.error ?? null,
+        });
+    }
+    /** Backfill a delivery fact discovered during downstream reconciliation. */
+    backfill(input) {
+        const { row, created } = this.insertIntent(input);
+        if (created || row.status !== 'delivered') {
+            this.recordAck(input.id, {
+                status: 'delivered',
+                remoteId: input.remoteId,
+                remoteStatus: input.remoteStatus ?? 'reconciled',
+            });
+        }
+        return { row: this.getById(input.id), created };
+    }
+    pending(limit = 200) {
+        const rows = this.db
+            .prepare(`SELECT * FROM deliveries WHERE status = 'pending' ORDER BY created_at ASC LIMIT ?`)
+            .all(limit);
+        return rows.map((r) => this.toRow(r));
+    }
+    countByStatus() {
+        const rows = this.db
+            .prepare(`SELECT status, COUNT(*) AS n FROM deliveries GROUP BY status`)
+            .all();
+        const out = { pending: 0, delivered: 0, duplicate: 0, failed: 0 };
+        for (const r of rows)
+            out[r.status] = r.n;
+        return out;
+    }
+    toRow(row) {
+        return {
+            id: row.id,
+            deliveryTarget: row.delivery_target,
+            workType: row.work_type,
+            pixivId: row.pixiv_id,
+            slotId: row.slot_id,
+            targetId: row.target_id,
+            idempotencyKey: row.idempotency_key,
+            status: row.status,
+            remoteId: row.remote_id,
+            remoteStatus: row.remote_status,
+            reuseReason: row.reuse_reason,
+            attempts: row.attempts,
+            lastError: row.last_error,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            deliveredAt: row.delivered_at,
+        };
+    }
+}
+exports.DeliveryRepository = DeliveryRepository;
+//# sourceMappingURL=DeliveryRepository.js.map

package/dist/storage/repositories/DeliveryRepository.js.map

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

package/dist/storage/repositories/MetadataRepository.d.ts

@@ -0,0 +1,27 @@
+import { BaseRepository } from './BaseRepository';
+export interface PixivMetadata {
+    pixivId: string;
+    workType: string;
+    language: string | null;
+    xRestrict: number | null;
+    publishedAt: string | null;
+    title: string | null;
+    checkedAt: number;
+}
+/**
+ * Lightweight SQLite metadata cache. Novel language filtering otherwise issues
+ * a full detail + full-text request for every candidate on every fallback run;
+ * caching the classified result bounds request volume and reduces 429 storms.
+ * Entries expire after a TTL so fresh classifications still happen eventually.
+ */
+export declare class MetadataRepository extends BaseRepository {
+    get(pixivId: string, workType: string): PixivMetadata | null;
+    fresh(pixivId: string, workType: string, ttlMs: number, now?: number): PixivMetadata | null;
+    put(pixivId: string, workType: string, data: {
+        language?: string | null;
+        xRestrict?: number | null;
+        publishedAt?: string | null;
+        title?: string | null;
+    }, now?: number): void;
+}
+//# sourceMappingURL=MetadataRepository.d.ts.map

package/dist/storage/repositories/MetadataRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataRepository.d.ts","sourceRoot":"","sources":["../../../src/storage/repositories/MetadataRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAgB5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,aAAa,GAAG,IAAI;IAOvG,GAAG,CACD,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EACjH,GAAG,GAAE,MAAmB,GACvB,IAAI;CAsBR"}

package/dist/storage/repositories/MetadataRepository.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataRepository = void 0;
+const BaseRepository_1 = require("./BaseRepository");
+/**
+ * Lightweight SQLite metadata cache. Novel language filtering otherwise issues
+ * a full detail + full-text request for every candidate on every fallback run;
+ * caching the classified result bounds request volume and reduces 429 storms.
+ * Entries expire after a TTL so fresh classifications still happen eventually.
+ */
+class MetadataRepository extends BaseRepository_1.BaseRepository {
+    get(pixivId, workType) {
+        const row = this.db
+            .prepare(`SELECT * FROM pixiv_metadata WHERE pixiv_id = ? AND work_type = ?`)
+            .get(String(pixivId), workType);
+        if (!row)
+            return null;
+        return {
+            pixivId: row.pixiv_id,
+            workType: row.work_type,
+            language: row.language,
+            xRestrict: row.x_restrict,
+            publishedAt: row.published_at,
+            title: row.title,
+            checkedAt: row.checked_at,
+        };
+    }
+    fresh(pixivId, workType, ttlMs, now = Date.now()) {
+        const row = this.get(pixivId, workType);
+        if (!row)
+            return null;
+        if (now - row.checkedAt > ttlMs)
+            return null;
+        return row;
+    }
+    put(pixivId, workType, data, now = Date.now()) {
+        this.db
+            .prepare(`INSERT INTO pixiv_metadata (pixiv_id, work_type, language, x_restrict, published_at, title, checked_at)
+         VALUES (@pixivId, @workType, @language, @xRestrict, @publishedAt, @title, @now)
+         ON CONFLICT(pixiv_id, work_type) DO UPDATE SET
+           language=excluded.language,
+           x_restrict=excluded.x_restrict,
+           published_at=excluded.published_at,
+           title=excluded.title,
+           checked_at=excluded.checked_at`)
+            .run({
+            pixivId: String(pixivId),
+            workType,
+            language: data.language ?? null,
+            xRestrict: data.xRestrict ?? null,
+            publishedAt: data.publishedAt ?? null,
+            title: data.title ?? null,
+            now,
+        });
+    }
+}
+exports.MetadataRepository = MetadataRepository;
+//# sourceMappingURL=MetadataRepository.js.map

package/dist/storage/repositories/MetadataRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MetadataRepository.js","sourceRoot":"","sources":["../../../src/storage/repositories/MetadataRepository.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAYlD;;;;;GAKG;AACH,MAAa,kBAAmB,SAAQ,+BAAc;IACpD,GAAG,CAAC,OAAe,EAAE,QAAgB;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CAAC,mEAAmE,CAAC;aAC5E,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAQ,CAAC;QACzC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,SAAS,EAAE,GAAG,CAAC,UAAU;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,QAAgB,EAAE,KAAa,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,GAAG,KAAK;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,GAAG,CACD,OAAe,EACf,QAAgB,EAChB,IAAiH,EACjH,MAAc,IAAI,CAAC,GAAG,EAAE;QAExB,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;;;;;0CAOkC,CACnC;aACA,GAAG,CAAC;YACH,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC;YACxB,QAAQ;YACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,GAAG;SACJ,CAAC,CAAC;IACP,CAAC;CACF;AAnDD,gDAmDC"}

package/dist/storage/repositories/OutboxRepository.d.ts

@@ -0,0 +1,72 @@
+import { BaseRepository } from './BaseRepository';
+export type OutboxKind = 'delivery' | 'notification';
+export type OutboxStatus = 'pending' | 'processing' | 'retry_wait' | 'done' | 'dead' | 'cancelled';
+export interface OutboxRow {
+    id: string;
+    kind: OutboxKind;
+    idempotencyKey: string | null;
+    deliveryId: string | null;
+    deliveryTarget: string;
+    payloadJson: string;
+    status: OutboxStatus;
+    attempts: number;
+    maxAttempts: number;
+    nextAttemptAt: number;
+    leaseOwner: string | null;
+    leaseUntil: number | null;
+    lastError: string | null;
+    createdAt: number;
+    updatedAt: number;
+    completedAt: number | null;
+}
+export interface NewOutboxItem {
+    kind: OutboxKind;
+    deliveryTarget: string;
+    idempotencyKey?: string | null;
+    deliveryId?: string | null;
+    payload: unknown;
+    /** Initial due time (epoch ms). Default now. */
+    dueAt?: number;
+    maxAttempts?: number;
+}
+/**
+ * SQLite transactional outbox. One durable row per intended external side
+ * effect (a content delivery or a notification). A single OutboxWorker claims
+ * due rows with a short lease, performs the effect, and marks them done. Rows
+ * survive process kill / machine stop; a restart simply resumes due rows.
+ */
+export declare class OutboxRepository extends BaseRepository {
+    static owner(): string;
+    /** Insert an intent. Returns the row. Idempotent on (kind, idempotency_key). */
+    enqueue(input: NewOutboxItem, now?: number): OutboxRow;
+    get(id: string): OutboxRow | null;
+    getByKey(kind: OutboxKind, key: string): OutboxRow | null;
+    list(status?: OutboxStatus, limit?: number): OutboxRow[];
+    /**
+     * Claim up to `limit` due rows for `owner`. Due = pending/retry_wait whose
+     * next_attempt_at has passed, OR processing rows whose lease expired (a
+     * crashed prior worker). The claim is a compare-and-set inside one
+     * statement, so two workers/processes never grab the same row.
+     */
+    claimDue(owner: string, leaseMs: number, limit: number, now?: number): OutboxRow[];
+    markDone(id: string, now?: number): void;
+    /** Schedule a later retry, or flip to dead once attempts are exhausted. */
+    markRetry(id: string, nextAt: number, error: string, now?: number): OutboxStatus;
+    /** Release a processing row back to pending without counting a retry. */
+    release(id: string, now?: number): void;
+    /** Reopen a dead row for one more attempt (operator / reconcile action). */
+    requeue(id: string, dueAt?: number): void;
+    cancel(id: string, now?: number): boolean;
+    counts(now?: number): {
+        pending: number;
+        retryWait: number;
+        processing: number;
+        dead: number;
+        done24h: number;
+        oldestPendingMs: number | null;
+    };
+    /** Rows still non-terminal (used by reconcile/doctor). */
+    staleProcessing(now?: number): OutboxRow[];
+    private toRow;
+}
+//# sourceMappingURL=OutboxRepository.d.ts.map

package/dist/storage/repositories/OutboxRepository.d.ts.map

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

package/dist/storage/repositories/OutboxRepository.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutboxRepository = void 0;
+const node_crypto_1 = require("node:crypto");
+const BaseRepository_1 = require("./BaseRepository");
+/**
+ * SQLite transactional outbox. One durable row per intended external side
+ * effect (a content delivery or a notification). A single OutboxWorker claims
+ * due rows with a short lease, performs the effect, and marks them done. Rows
+ * survive process kill / machine stop; a restart simply resumes due rows.
+ */
+class OutboxRepository extends BaseRepository_1.BaseRepository {
+    static owner() {
+        return `${process.pid}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+    }
+    /** Insert an intent. Returns the row. Idempotent on (kind, idempotency_key). */
+    enqueue(input, now = Date.now()) {
+        const id = (0, node_crypto_1.randomUUID)();
+        const payloadJson = JSON.stringify(input.payload ?? {});
+        this.db
+            .prepare(`INSERT INTO outbox
+           (id, kind, idempotency_key, delivery_id, delivery_target, payload_json,
+            status, attempts, max_attempts, next_attempt_at, created_at, updated_at)
+         VALUES
+           (@id, @kind, @idempotencyKey, @deliveryId, @deliveryTarget, @payloadJson,
+            'pending', 0, @maxAttempts, @dueAt, @now, @now)
+         ON CONFLICT(kind, idempotency_key) WHERE idempotency_key IS NOT NULL
+         DO UPDATE SET updated_at = @now`)
+            .run({
+            id,
+            kind: input.kind,
+            idempotencyKey: input.idempotencyKey ?? null,
+            deliveryId: input.deliveryId ?? null,
+            deliveryTarget: input.deliveryTarget,
+            payloadJson,
+            maxAttempts: input.maxAttempts ?? 12,
+            dueAt: input.dueAt ?? now,
+            now,
+        });
+        // On conflict the existing row is authoritative; fetch by the natural key.
+        if (input.idempotencyKey) {
+            return this.getByKey(input.kind, input.idempotencyKey);
+        }
+        return this.get(id);
+    }
+    get(id) {
+        const row = this.db.prepare(`SELECT * FROM outbox WHERE id = ?`).get(id);
+        return row ? this.toRow(row) : null;
+    }
+    getByKey(kind, key) {
+        const row = this.db
+            .prepare(`SELECT * FROM outbox WHERE kind = ? AND idempotency_key = ?`)
+            .get(kind, key);
+        return row ? this.toRow(row) : null;
+    }
+    list(status, limit = 100) {
+        const bounded = Math.max(1, Math.min(Math.trunc(limit), 500));
+        const rows = status
+            ? this.db.prepare(`SELECT * FROM outbox WHERE status=? ORDER BY created_at DESC LIMIT ?`).all(status, bounded)
+            : this.db.prepare(`SELECT * FROM outbox ORDER BY created_at DESC LIMIT ?`).all(bounded);
+        return rows.map((row) => this.toRow(row));
+    }
+    /**
+     * Claim up to `limit` due rows for `owner`. Due = pending/retry_wait whose
+     * next_attempt_at has passed, OR processing rows whose lease expired (a
+     * crashed prior worker). The claim is a compare-and-set inside one
+     * statement, so two workers/processes never grab the same row.
+     */
+    claimDue(owner, leaseMs, limit, now = Date.now()) {
+        const ids = this.db
+            .prepare(`SELECT id FROM outbox
+         WHERE status IN ('pending','retry_wait') AND next_attempt_at <= @now
+            OR (status = 'processing' AND lease_until IS NOT NULL AND lease_until <= @now)
+         ORDER BY next_attempt_at ASC
+         LIMIT @limit`)
+            .all({ now, limit }).map((r) => r.id);
+        if (ids.length === 0)
+            return [];
+        const claim = this.db.prepare(`UPDATE outbox
+       SET status = 'processing', lease_owner = @owner, lease_until = @until, updated_at = @now
+       WHERE id = @id
+         AND (status IN ('pending','retry_wait') AND next_attempt_at <= @now
+              OR (status = 'processing' AND lease_until IS NOT NULL AND lease_until <= @now))`);
+        const out = [];
+        const tx = this.db.transaction((rows) => {
+            for (const id of rows) {
+                const info = claim.run({ id, owner, until: now + leaseMs, now });
+                if (info.changes > 0) {
+                    const row = this.get(id);
+                    if (row)
+                        out.push(row);
+                }
+            }
+        });
+        tx(ids);
+        return out;
+    }
+    markDone(id, now = Date.now()) {
+        this.db
+            .prepare(`UPDATE outbox
+         SET status='done', lease_owner=NULL, lease_until=NULL, last_error=NULL,
+             completed_at=@now, updated_at=@now
+         WHERE id=@id`)
+            .run({ id, now });
+    }
+    /** Schedule a later retry, or flip to dead once attempts are exhausted. */
+    markRetry(id, nextAt, error, now = Date.now()) {
+        const row = this.get(id);
+        if (!row)
+            return 'dead';
+        const attempts = row.attempts + 1;
+        const dead = attempts >= row.maxAttempts;
+        this.db
+            .prepare(`UPDATE outbox
+         SET attempts=@attempts,
+             status=@status,
+             next_attempt_at=@nextAt,
+             lease_owner=NULL, lease_until=NULL,
+             last_error=@error, updated_at=@now
+         WHERE id=@id`)
+            .run({
+            id,
+            attempts,
+            status: dead ? 'dead' : 'retry_wait',
+            nextAt: dead ? row.nextAttemptAt : nextAt,
+            error: error.slice(0, 1000),
+            now,
+        });
+        return dead ? 'dead' : 'retry_wait';
+    }
+    /** Release a processing row back to pending without counting a retry. */
+    release(id, now = Date.now()) {
+        this.db
+            .prepare(`UPDATE outbox SET status='pending', lease_owner=NULL, lease_until=NULL,
+                 next_attempt_at=@now, updated_at=@now WHERE id=@id AND status='processing'`)
+            .run({ id, now });
+    }
+    /** Reopen a dead row for one more attempt (operator / reconcile action). */
+    requeue(id, dueAt = Date.now()) {
+        this.db
+            .prepare(`UPDATE outbox SET status='retry_wait', next_attempt_at=@dueAt, attempts=0,
+                 last_error=NULL, lease_owner=NULL, lease_until=NULL,
+                 completed_at=NULL, updated_at=@dueAt WHERE id=@id`)
+            .run({ id, dueAt });
+    }
+    cancel(id, now = Date.now()) {
+        const result = this.db.prepare(`UPDATE outbox SET status='cancelled', lease_owner=NULL, lease_until=NULL,
+              last_error='cancelled by operator', completed_at=@now, updated_at=@now
+       WHERE id=@id AND status IN ('pending','retry_wait','dead')`).run({ id, now });
+        return result.changes === 1;
+    }
+    counts(now = Date.now()) {
+        const one = (sql, ...params) => this.db.prepare(sql).get(...params).n;
+        const pending = one(`SELECT COUNT(*) n FROM outbox WHERE status IN ('pending','retry_wait')`);
+        const retryWait = one(`SELECT COUNT(*) n FROM outbox WHERE status='retry_wait'`);
+        const processing = one(`SELECT COUNT(*) n FROM outbox WHERE status='processing'`);
+        const dead = one(`SELECT COUNT(*) n FROM outbox WHERE status='dead'`);
+        const done24h = one(`SELECT COUNT(*) n FROM outbox WHERE status='done' AND completed_at >= ?`, now - 86_400_000);
+        const oldest = this.db
+            .prepare(`SELECT MIN(next_attempt_at) t FROM outbox WHERE status IN ('pending','retry_wait')`)
+            .get();
+        return {
+            pending,
+            retryWait,
+            processing,
+            dead,
+            done24h,
+            oldestPendingMs: oldest.t == null ? null : Math.max(0, now - oldest.t),
+        };
+    }
+    /** Rows still non-terminal (used by reconcile/doctor). */
+    staleProcessing(now = Date.now()) {
+        const rows = this.db
+            .prepare(`SELECT * FROM outbox WHERE status='processing' AND lease_until IS NOT NULL AND lease_until <= ?`)
+            .all(now);
+        return rows.map((r) => this.toRow(r));
+    }
+    toRow(row) {
+        return {
+            id: row.id,
+            kind: row.kind,
+            idempotencyKey: row.idempotency_key,
+            deliveryId: row.delivery_id,
+            deliveryTarget: row.delivery_target,
+            payloadJson: row.payload_json,
+            status: row.status,
+            attempts: row.attempts,
+            maxAttempts: row.max_attempts,
+            nextAttemptAt: row.next_attempt_at,
+            leaseOwner: row.lease_owner,
+            leaseUntil: row.lease_until,
+            lastError: row.last_error,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            completedAt: row.completed_at,
+        };
+    }
+}
+exports.OutboxRepository = OutboxRepository;
+//# sourceMappingURL=OutboxRepository.js.map

package/dist/storage/repositories/OutboxRepository.js.map

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

package/dist/storage/repositories/SlotRepository.d.ts

@@ -1,6 +1,6 @@
 import { BaseRepository } from './BaseRepository';
 export type SlotStatus = 'pending' | 'running' | 'success' | 'partial' | 'failed' | 'expired';
-export type CellStatus = 'pending' | 'selected' | 'submitted' | 'no_candidate' | 'failed';
+export type CellStatus = 'pending' | 'selected' | 'artifact_ready' | 'delivery_pending' | 'submitted' | 'no_candidate' | 'duplicate' | 'failed';
 export interface SlotRecord {
     id: string;
     /** Schedule this occurrence belongs to (id is already schedule-scoped). */
@@ -22,6 +22,9 @@ export interface SlotRecord {
     startedAt: string | null;
     completedAt: string | null;
     lastError: string | null;
+    leaseOwner: string | null;
+    leaseUntil: number | null;
+    heartbeatAt: number | null;
 }
 export interface SlotItemRecord {
     id: number;
@@ -92,6 +95,28 @@ export declare class SlotRepository extends BaseRepository {
     /** Explicit operator action: forget the locked work so a re-run picks another candidate. */
     clearCellWork(slotId: string, targetId: string): void;
     setCellStatus(slotId: string, targetId: string, status: CellStatus, error?: string): void;
+    /**
+     * Transition a cell with FSM validation. Never downgrades a confirmed cell;
+     * an illegal transition throws rather than silently corrupting state.
+     */
+    transitionCell(slotId: string, targetId: string, next: CellStatus, error?: string): SlotItemRecord;
+    /**
+     * Claim execution ownership of a slot for `owner` until `leaseUntil`
+     * (epoch ms). Returns true when this caller now owns the lease. A second
+     * process/trigger sees an active lease and must converge (resume/observe),
+     * not start a parallel run. An expired lease is reclaimable.
+     */
+    claimSlotLease(slotId: string, owner: string, leaseUntil: number, now?: number): boolean;
+    heartbeatSlotLease(slotId: string, owner: string, leaseUntil: number, now?: number): void;
+    releaseSlotLease(slotId: string, owner: string): void;
+    getSlotLease(slotId: string): {
+        owner: string | null;
+        until: number | null;
+    };
+    /** Slots whose lease expired while still non-terminal (crashed workers). */
+    slotsWithStaleLease(now?: number): string[];
+    /** Record an error without changing terminality (retryable failure keeps the cell resumable). */
+    setCellError(slotId: string, targetId: string, error: string): void;
     /** Work ids already locked in THIS slot (to stop two cells taking the same work). */
     getLockedWorkIds(slotId: string): Set<string>;
     /** Roll up a slot's status from its cells. */

package/dist/storage/repositories/SlotRepository.d.ts.map

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