pixivflow 2.20.2 → 2.20.3

package/dist/commands/scheduler-runtime.d.ts

@@ -111,6 +111,14 @@ export interface SchedulerRuntime {
     close(): void;
 }
 export declare function notifyScheduleFailure(config: StandaloneConfig, database: Database, schedule: ScheduleConfig, failure: JobFailure): Promise<void>;
+/**
+ * Expanded, still-bounded candidate scan bound for one fallback stage
+ * (§schedule-recovery). Stage 0 is the primary pass; stage N scans
+ * `base * (N + 1)` candidates, hard-capped so a fallback can never become an
+ * unbounded scan of the whole tag. `undefined` (no declared bound) stays
+ * `undefined`: the handler's own default applies, not a fabricated number.
+ */
+export declare function fallbackScanLimit(base: number | undefined, stage: number): number | undefined;
 export declare function createSchedulerRuntime(configPathArg?: string): Promise<SchedulerRuntime>;
 /**
  * Watchdog for a single plan run (used by `run-once`; the daemon's cron runs

package/dist/commands/scheduler-runtime.js

@@ -45,6 +45,7 @@ exports.EXECUTION_MODES = void 0;
 exports.withDeliveryMode = withDeliveryMode;
 exports.shouldTerminaliseAbortedSlot = shouldTerminaliseAbortedSlot;
 exports.notifyScheduleFailure = notifyScheduleFailure;
+exports.fallbackScanLimit = fallbackScanLimit;
 exports.createSchedulerRuntime = createSchedulerRuntime;
 exports.runWithTimeout = runWithTimeout;
 const config_1 = require("../config");
@@ -199,6 +200,16 @@ function buildProxyUrl(network) {
     const auth = proxy.username ? `${proxy.username}:${proxy.password ?? ''}@` : '';
     return `${protocol}://${auth}${proxy.host}:${proxy.port}`;
 }
+/**
+ * Expanded, still-bounded candidate scan bound for one fallback stage
+ * (§schedule-recovery). Stage 0 is the primary pass; stage N scans
+ * `base * (N + 1)` candidates, hard-capped so a fallback can never become an
+ * unbounded scan of the whole tag. `undefined` (no declared bound) stays
+ * `undefined`: the handler's own default applies, not a fabricated number.
+ */
+function fallbackScanLimit(base, stage) {
+    return base === undefined ? undefined : Math.min(Math.max(base, 1) * (stage + 1), 100);
+}
 async function createSchedulerRuntime(configPathArg) {
     logger_1.logger.info('PixivFlow runtime starting', { component: 'pixivflow', version: version_1.BUILD.version, commit: version_1.BUILD.commit });
     // Keep TODAY/YESTERDAY placeholders intact. They are resolved afresh for
@@ -445,21 +456,53 @@ async function createSchedulerRuntime(configPathArg) {
                 targets: runTargets.map((t) => t.id),
             });
         }
-        const downloadManager = new DownloadManager_1.DownloadManager(scopedConfig, pixivClient, database, fileService);
-        if (targetExecutionContexts)
-            downloadManager.setTargetExecutionContexts(targetExecutionContexts);
-        if (options.excludedWorkIds)
-            downloadManager.setProcessedWorkIds(options.excludedWorkIds);
-        activeDownloadManager = downloadManager;
-        await downloadManager.initialise();
         const scheduleSlot = slotCtx; // stable for callbacks; null for ad-hoc runs
+        // Bounded candidate fallback budget (§schedule-recovery): a missing required
+        // target must exhaust its recovery stages before the occurrence may roll up
+        // as a degraded (partial) terminal result.
+        const maxFallbackStages = Math.max(0, Math.min(10, Number(runtimeConfig.download?.maxFallbackStages ?? 3)));
+        const boostScanLimit = fallbackScanLimit;
+        const boostedTargets = (list, stage) => stage === 0
+            ? list
+            : list.map((t) => ({
+                ...t,
+                candidateScanLimit: boostScanLimit(t.candidateScanLimit ?? runtimeConfig.download?.candidateScanLimit, stage),
+            }));
+        const buildManager = (list) => {
+            const scoped = {
+                ...runtimeConfig,
+                targets: withDeliveryMode(list.map((t) => ({
+                    ...t,
+                    delivery: t.delivery
+                        ? { ...t.delivery, slotContext: slotCtx ?? undefined, executionContext }
+                        : t.delivery,
+                })), options.deliveryMode),
+            };
+            const manager = new DownloadManager_1.DownloadManager(scoped, pixivClient, database, fileService);
+            if (targetExecutionContexts)
+                manager.setTargetExecutionContexts(targetExecutionContexts);
+            if (options.excludedWorkIds)
+                manager.setProcessedWorkIds(options.excludedWorkIds);
+            manager.setTargetOutcomeHook(outcomeHook);
+            if (scheduleSlot) {
+                manager.slotContext = {
+                    slotId: scheduleSlot.slotId,
+                    scheduleId: scheduleSlot.scheduleId,
+                    occurrenceAtIso: new Date(scheduleSlot.occurrenceAt).toISOString(),
+                    triggerSource: scheduleSlot.triggerSource,
+                    slotName: scheduleSlot.slotName,
+                    slotDate: scheduleSlot.slotDate,
+                };
+            }
+            return manager;
+        };
         // TYPED outcome -> explicit FSM transition. No message regex, no
         // "no throw => submitted". Only a confirmed ACK yields 'submitted'.
         //
         // Registered for EVERY run, not just scheduled ones: the batch runner
         // (execute-slot) runs without a Slot and still has to report a
         // machine-readable per-target result to its caller.
-        downloadManager.setTargetOutcomeHook((target, outcome) => {
+        const outcomeHook = (target, outcome) => {
             if (!target.id)
                 return;
             options.onTargetOutcome?.(target.id, outcome);
@@ -467,6 +510,21 @@ async function createSchedulerRuntime(configPathArg) {
                 // No durable slot (run-once CLI): nothing to converge or report.
                 return;
             }
+            // A scheduled (non-manual) target with nothing to submit advances to its
+            // next bounded fallback stage instead of terminalising: the cell returns
+            // to `pending` and the next pass re-selects it with expanded scan bounds.
+            // The FINAL stage (stage == maxFallbackStages - 1) does NOT advance: its
+            // real terminal outcome (no_candidate / duplicate / failed) is applied, so
+            // an exhausted occurrence reports the true cause — never a generic
+            // "target did not complete".
+            if (!scheduleSlot.manualRequestId &&
+                (outcome.kind === 'no_candidate' || outcome.kind === 'duplicate') &&
+                coordinator.cellFallbackStage(scheduleSlot.slotId, target.id) < maxFallbackStages - 1) {
+                coordinator.advanceFallback(scheduleSlot.slotId, target.id, outcome.kind === 'duplicate'
+                    ? `duplicate candidates (stage ${coordinator.cellFallbackStage(scheduleSlot.slotId, target.id)})`
+                    : outcome.reason ?? 'no eligible candidate', maxFallbackStages);
+                return;
+            }
             coordinator.applyOutcome(scheduleSlot.slotId, target.id, outcome);
             notificationPolicy.noteOutcome(scheduleSlot.slotId, scheduleSlot, schedule, target, outcome);
             if (scheduleSlot.manualRequestId && (outcome.kind === 'no_candidate' || outcome.kind === 'duplicate' ||
@@ -475,17 +533,10 @@ async function createSchedulerRuntime(configPathArg) {
                 // fallback for retry exhaustion, timeout, and outbox dead-letter.
                 notificationPolicy.noteRefetchOutcome(scheduleSlot, schedule, target, scheduleSlot.manualRequestId, outcome);
             }
-        });
-        if (scheduleSlot) {
-            downloadManager.slotContext = {
-                slotId: scheduleSlot.slotId,
-                scheduleId: scheduleSlot.scheduleId,
-                occurrenceAtIso: new Date(scheduleSlot.occurrenceAt).toISOString(),
-                triggerSource: scheduleSlot.triggerSource,
-                slotName: scheduleSlot.slotName,
-                slotDate: scheduleSlot.slotDate,
-            };
-        }
+        };
+        let downloadManager = buildManager(boostedTargets(runTargets, 0));
+        activeDownloadManager = downloadManager;
+        await downloadManager.initialise();
         // Apply initial delay if configured
         if (runtimeConfig.initialDelay && runtimeConfig.initialDelay > 0) {
             logger_1.logger.info(`Waiting ${runtimeConfig.initialDelay}ms before starting download...`, {
@@ -507,7 +558,25 @@ async function createSchedulerRuntime(configPathArg) {
         if (slotCtx && varReleaseLease)
             releaseLease = varReleaseLease;
         try {
-            await downloadManager.runAllTargets();
+            // Candidate fallback passes (§schedule-recovery): after each pass, cells
+            // still mid-fallback (advanced stages) are re-selected with expanded,
+            // still-bounded scan limits. Successful sibling cells are NEVER re-run:
+            // pendingTargets only returns unconverged cells of this slot.
+            for (let pass = 0;; pass += 1) {
+                await downloadManager.runAllTargets();
+                if (!slotCtx || pass >= maxFallbackStages - 1)
+                    break;
+                const pendingFallback = coordinator
+                    .pendingTargets(slotCtx.slotId, targets)
+                    .filter((p) => p.cell &&
+                    p.cell.fallback_stage > 0 &&
+                    p.cell.fallback_stage < maxFallbackStages);
+                if (pendingFallback.length === 0)
+                    break;
+                downloadManager = buildManager(boostedTargets(pendingFallback.map((p) => p.target), pass + 1));
+                activeDownloadManager = downloadManager;
+                await downloadManager.initialise();
+            }
         }
         catch (error) {
             if (!slotCtx || !(error instanceof Error) || !/^All \d+ target\(s\) failed\./.test(error.message)) {

package/dist/config/types.d.ts

@@ -524,6 +524,12 @@ export interface HttpMultipartDeliveryConfig {
      * `headers` for auth, so no extra credential is needed.
      */
     refetchOutcomeUrl?: string;
+    /**
+     * Optional JSON endpoint for TERMINAL SCHEDULE occurrence summaries
+     * (success/partial/failed) — delivered by the durable outbox to TelePost,
+     * which relays a user/operator-visible message. Reuses `headers` for auth.
+     */
+    scheduleOutcomeUrl?: string;
     method?: 'POST' | 'PUT';
     /** 支持 ${ENV_NAME} 环境变量插值 */
     headers?: Record<string, string>;
@@ -683,6 +689,12 @@ export interface StandaloneConfig {
          * Default: 5 (clamped to 1..100)
          */
         candidateScanLimit?: number;
+        /**
+         * Bounded candidate-fallback budget for SCHEDULED occurrences
+         * (§schedule-recovery). 0 disables fallback (no_candidate/duplicate
+         * terminalises immediately). Default: 3.
+         */
+        maxFallbackStages?: number;
     };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/config/validation.js

@@ -312,6 +312,16 @@ function validateConfig(config, location, databasePath) {
                     errors.push(`${prefix}.refetchOutcomeUrl: Must be a valid HTTP or HTTPS URL`);
                 }
             }
+            if (delivery.scheduleOutcomeUrl && !/\$\{[A-Za-z_][A-Za-z0-9_]*\}/.test(delivery.scheduleOutcomeUrl)) {
+                try {
+                    const url = new URL(delivery.scheduleOutcomeUrl);
+                    if (!['http:', 'https:'].includes(url.protocol))
+                        throw new Error('unsupported protocol');
+                }
+                catch {
+                    errors.push(`${prefix}.scheduleOutcomeUrl: Must be a valid HTTP or HTTPS URL`);
+                }
+            }
             if (delivery.readinessUrl && !/\$\{[A-Za-z_][A-Za-z0-9_]*\}/.test(delivery.readinessUrl)) {
                 try {
                     const url = new URL(delivery.readinessUrl);

package/dist/delivery/DeliveryDispatcher.js

@@ -53,8 +53,13 @@ class DeliveryDispatcher {
         if (target.type !== 'httpMultipart') {
             throw new errors_1.ConfigError(`Unsupported delivery target type: ${target.type}`);
         }
-        if (!(request.refetchOutcome ? target.refetchOutcomeUrl : target.notificationUrl)?.trim()) {
-            throw new errors_1.ConfigError(`Delivery target does not configure ${request.refetchOutcome ? 'refetchOutcomeUrl' : 'notificationUrl'}: ${name}`);
+        const urlKey = request.refetchOutcome
+            ? 'refetchOutcomeUrl'
+            : request.scheduleOutcome
+                ? 'scheduleOutcomeUrl'
+                : 'notificationUrl';
+        if (!target[urlKey]?.trim()) {
+            throw new errors_1.ConfigError(`Delivery target does not configure ${urlKey}: ${name}`);
         }
         return new HttpMultipartDelivery_1.HttpMultipartDelivery(target, this.proxyUrl).notifyOnce(request);
     }

package/dist/delivery/DeliveryService.d.ts

@@ -39,6 +39,19 @@ export interface RefetchOutcomePayload {
         unavailable: number;
     };
 }
+/** Terminal SCHEDULE occurrence verdict (success/partial/failed), reported via
+ * the durable outbox to TelePost, which relays the user-visible summary. */
+export interface ScheduleOutcomePayload {
+    scheduleId: string;
+    slotId: string;
+    status: 'success' | 'partial' | 'failed';
+    targets?: Array<{
+        targetId: string;
+        workType: string;
+        status: string;
+        workId?: string | null;
+    }>;
+}
 export declare class DeliveryService {
     private readonly database;
     constructor(database: Database);
@@ -96,7 +109,7 @@ export declare class DeliveryService {
         created: boolean;
     };
     /** Enqueue a durable notification (retried independently; never affects content). */
-    enqueueNotification(deliveryTarget: string, text: string, idempotencyKey: string, refetchOutcome?: RefetchOutcomePayload): void;
+    enqueueNotification(deliveryTarget: string, text: string, idempotencyKey: string, refetchOutcome?: RefetchOutcomePayload, scheduleOutcome?: ScheduleOutcomePayload): void;
     private guardCell;
     private contextFrom;
 }

package/dist/delivery/DeliveryService.js

@@ -175,12 +175,16 @@ class DeliveryService {
         return { deliveryId: row.id, created };
     }
     /** Enqueue a durable notification (retried independently; never affects content). */
-    enqueueNotification(deliveryTarget, text, idempotencyKey, refetchOutcome) {
+    enqueueNotification(deliveryTarget, text, idempotencyKey, refetchOutcome, scheduleOutcome) {
         this.database.outbox.enqueue({
             kind: 'notification',
             deliveryTarget,
             idempotencyKey,
-            payload: refetchOutcome ? { text, refetchOutcome } : { text },
+            payload: refetchOutcome
+                ? { text, refetchOutcome }
+                : scheduleOutcome
+                    ? { text, scheduleOutcome }
+                    : { text },
         });
     }
     guardCell(slotId, targetId, next) {

package/dist/delivery/HttpMultipartDelivery.js

@@ -134,18 +134,23 @@ class HttpMultipartDelivery {
     /** Single notification attempt; the outbox owns retries. */
     async notifyOnce(request) {
         const outcome = request.refetchOutcome;
-        const url = (outcome ? this.config.refetchOutcomeUrl?.trim() : this.config.notificationUrl?.trim());
+        const scheduleOutcome = request.scheduleOutcome;
+        const url = (outcome ? this.config.refetchOutcomeUrl?.trim()
+            : scheduleOutcome ? this.config.scheduleOutcomeUrl?.trim()
+                : this.config.notificationUrl?.trim());
         if (!url) {
             throw new Error(outcome
                 ? 'HTTP delivery refetchOutcomeUrl is not configured'
-                : 'HTTP delivery notificationUrl is not configured');
+                : scheduleOutcome
+                    ? 'HTTP delivery scheduleOutcomeUrl is not configured'
+                    : 'HTTP delivery notificationUrl is not configured');
         }
         const headers = {
             ...this.resolveHeaders(this.config.headers ?? {}),
             'Content-Type': 'application/json',
         };
-        // Refetch verdicts are machine-readable JSON (the requester's review state
-        // machine consumes disposition, not prose). Plain notifications remain
+        // Refetch verdicts and schedule outcomes are machine-readable JSON for
+        // TelePost's state machines/relays. Plain notifications remain
         // {text, idempotency_key}.
         const body = outcome
             ? {
@@ -156,7 +161,19 @@ class HttpMultipartDelivery {
                 scanned: outcome.scanned,
                 skipped: outcome.skipped,
             }
-            : { text: request.text, idempotency_key: request.idempotencyKey };
+            : scheduleOutcome
+                ? {
+                    schedule_id: scheduleOutcome.scheduleId,
+                    slot_id: scheduleOutcome.slotId,
+                    status: scheduleOutcome.status,
+                    targets: (scheduleOutcome.targets ?? []).map((t) => ({
+                        target_id: t.targetId,
+                        work_type: t.workType,
+                        status: t.status,
+                        work_id: t.workId ?? null,
+                    })),
+                }
+                : { text: request.text, idempotency_key: request.idempotencyKey };
         const options = {
             method: 'POST',
             headers,

package/dist/delivery/OutboxWorker.d.ts

@@ -31,6 +31,8 @@ export interface NotificationPayload {
     text: string;
     /** Optional structured remote-manual-replacement verdict (refetch outcome). */
     refetchOutcome?: unknown;
+    /** Optional structured terminal SCHEDULE occurrence verdict. */
+    scheduleOutcome?: unknown;
 }
 /** Exponential backoff with jitter, capped. */
 export declare function backoffDelayMs(attempt: number, base: number, max: number): number;

package/dist/delivery/OutboxWorker.js

@@ -214,6 +214,9 @@ class OutboxWorker {
                     refetchOutcome: payload.refetchOutcome !== undefined
                         ? payload.refetchOutcome
                         : undefined,
+                    scheduleOutcome: payload.scheduleOutcome !== undefined
+                        ? payload.scheduleOutcome
+                        : undefined,
                 });
             }
             else {

package/dist/delivery/types.d.ts

@@ -113,6 +113,22 @@ export interface DeliveryNotificationRequest {
             unavailable: number;
         };
     };
+    /**
+     * Structured terminal schedule verdict for a SCHEDULED occurrence. When
+     * present the delivery posts JSON to `scheduleOutcomeUrl` instead of
+     * `notificationUrl` (auth reuses `headers`).
+     */
+    scheduleOutcome?: {
+        scheduleId: string;
+        slotId: string;
+        status: 'success' | 'partial' | 'failed';
+        targets?: Array<{
+            targetId: string;
+            workType: string;
+            status: string;
+            workId?: string | null;
+        }>;
+    };
 }
 export interface DeliveryProvider {
     deliver(request: DeliveryRequest): Promise<DeliveryResult>;

package/dist/notification/NotificationPolicy.d.ts

@@ -45,6 +45,12 @@ export declare class NotificationPolicy {
         workId: string | null;
         error: string | null;
     }>): void;
+    /**
+     * Delivery targets whose HTTP target declares the given outcome URL.
+     * Schedule summaries require `scheduleOutcomeUrl`; manual refetch outcomes
+     * use `refetchOutcomeUrl`; generic notifications use `notificationUrl`.
+     */
+    private targetsWithUrl;
     private send;
     /**
      * Report the terminal verdict of a REMOTE MANUAL replacement ("重抓") back to

package/dist/notification/NotificationPolicy.js

@@ -76,8 +76,8 @@ class NotificationPolicy {
     }
     /** One consolidated summary per slot, delivered to every notifying target's endpoint. */
     sendSlotSummary(slot, schedule, rows) {
-        const notifiable = this.notifiableTargets();
-        if (notifiable.size === 0 || rows.length === 0)
+        const targets = this.targetsWithUrl('scheduleOutcomeUrl');
+        if (targets.size === 0 || rows.length === 0)
             return;
         const icon = (s) => s === 'submitted' ? '✅' : s === 'no_candidate' ? '⚠️' : s === 'duplicate' ? '♱' : s === 'delivery_pending' ? '🕓' : '❌';
         const lines = rows.map((r) => `${icon(r.status)} ${r.label}（${r.workType === 'novel' ? '小说' : '插画'}）` +
@@ -91,10 +91,39 @@ class NotificationPolicy {
             ...lines,
             `结果：${submitted === rows.length ? 'success' : submitted > 0 ? 'partial' : 'failed'}（${submitted}/${rows.length} 已确认投递）`,
         ].join('\n');
+        const outcomeStatus = submitted === rows.length ? 'success' : submitted > 0 ? 'partial' : 'failed';
         const service = new DeliveryService_1.DeliveryService(this.database);
-        for (const name of notifiable) {
-            service.enqueueNotification(name, text, NotificationPolicy.keys.summary(slot.slotId));
+        for (const name of targets) {
+            service.enqueueNotification(name, text, NotificationPolicy.keys.summary(slot.slotId), undefined, {
+                scheduleId: schedule.id,
+                slotId: slot.slotId,
+                status: outcomeStatus,
+                targets: rows.map((r) => ({
+                    targetId: r.targetId,
+                    workType: r.workType,
+                    status: r.status,
+                    workId: r.workId,
+                })),
+            });
+        }
+    }
+    /**
+     * Delivery targets whose HTTP target declares the given outcome URL.
+     * Schedule summaries require `scheduleOutcomeUrl`; manual refetch outcomes
+     * use `refetchOutcomeUrl`; generic notifications use `notificationUrl`.
+     */
+    targetsWithUrl(urlKey) {
+        const result = new Set();
+        for (const target of this.config.targets ?? []) {
+            const deliveryTarget = target.delivery?.target;
+            if (!deliveryTarget)
+                continue;
+            const delivery = this.config.delivery?.targets?.[deliveryTarget];
+            if (delivery?.type === 'httpMultipart' && delivery[urlKey]?.trim()) {
+                result.add(deliveryTarget);
+            }
         }
+        return result;
     }
     send(targetName, key, text) {
         try {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow",
-  "version": "2.20.2",
+  "version": "2.20.3",
   "private": true
 }

package/dist/scheduler/SlotCoordinator.d.ts

@@ -252,7 +252,20 @@ export declare class SlotCoordinator {
     claimRunLease(slotId: string, owner: string, leaseMs: number): boolean;
     heartbeatLease(slotId: string, owner: string, leaseMs: number): void;
     releaseRunLease(slotId: string, owner: string): void;
-    /** Roll cell results up into the slot status (one place computes the aggregate). */
+    /**
+     * Current durable fallback stage of a cell (0 = primary selection pass).
+     * Mirrors the repository accessor so scheduler-runtime reads one surface.
+     */
+    cellFallbackStage(slotId: string, targetId: string): number;
+    /**
+     * Advance a recoverable candidate cell to its next durable fallback stage
+     * (§schedule-recovery). no_candidate/duplicate from a non-final stage MUST
+     * NOT terminalize: pendingTargets then re-selects the same target with
+     * expanded, still-bounded scan parameters. Returns the new stage, or the
+     * previous stage when the budget was already exhausted (callers then let the
+     * terminal outcome apply).
+     */
+    advanceFallback(slotId: string, targetId: string, reason: string, maxStages: number): number;
     finish(slot: SlotContext, schedule: ScheduleConfig, targets: TargetConfig[]): SlotRunSummary;
     /**
      * Project the terminal slot row into the one structured outcome record. Every

package/dist/scheduler/SlotCoordinator.js

@@ -355,7 +355,31 @@ class SlotCoordinator {
     releaseRunLease(slotId, owner) {
         this.database.slots.releaseSlotLease(slotId, owner);
     }
-    /** Roll cell results up into the slot status (one place computes the aggregate). */
+    /**
+     * Current durable fallback stage of a cell (0 = primary selection pass).
+     * Mirrors the repository accessor so scheduler-runtime reads one surface.
+     */
+    cellFallbackStage(slotId, targetId) {
+        return this.database.slots.cellFallbackStage(slotId, targetId);
+    }
+    /**
+     * Advance a recoverable candidate cell to its next durable fallback stage
+     * (§schedule-recovery). no_candidate/duplicate from a non-final stage MUST
+     * NOT terminalize: pendingTargets then re-selects the same target with
+     * expanded, still-bounded scan parameters. Returns the new stage, or the
+     * previous stage when the budget was already exhausted (callers then let the
+     * terminal outcome apply).
+     */
+    advanceFallback(slotId, targetId, reason, maxStages) {
+        const current = this.database.slots.cellFallbackStage(slotId, targetId);
+        if (current >= maxStages)
+            return current;
+        const next = this.database.slots.bumpFallbackStage(slotId, targetId, reason);
+        logger_1.logger.info('Candidate fallback advanced', {
+            slot: slotId, target: targetId, stage: next, reason: String(reason).slice(0, 160),
+        });
+        return next;
+    }
     finish(slot, schedule, targets) {
         const membership = this.database.slots.getSlotTargetIds(slot.slotId);
         const ids = membership.length > 0 ? membership : targets.map((t) => t.id).filter(Boolean);

package/dist/storage/DatabaseMigration.js

@@ -124,6 +124,7 @@ class DatabaseMigration {
             work_type TEXT,
             status TEXT NOT NULL DEFAULT 'pending',
             attempt_count INTEGER NOT NULL DEFAULT 0,
+            fallback_stage INTEGER NOT NULL DEFAULT 0,
             last_error TEXT,
             created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
             updated_at DATETIME DEFAULT CURRENT_TIMESTAMP,
@@ -244,6 +245,10 @@ class DatabaseMigration {
                 if (!slotCols.includes(col))
                     columnAlters.push(sql);
             }
+            const itemCols = this.db.prepare(`PRAGMA table_info(schedule_slot_items)`).all().map((c) => c.name);
+            if (!itemCols.includes('fallback_stage')) {
+                columnAlters.push(`ALTER TABLE schedule_slot_items ADD COLUMN fallback_stage INTEGER NOT NULL DEFAULT 0`);
+            }
             // Create indexes for better query performance
             const indexes = [
                 `CREATE INDEX IF NOT EXISTS idx_downloads_pixiv_id_type ON downloads(pixiv_id, type)`,

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

@@ -38,6 +38,12 @@ export interface SlotItemRecord {
     workType: string | null;
     status: CellStatus;
     attemptCount: number;
+    /**
+     * Bounded candidate-fallback depth for this cell (§schedule-recovery). 0 means
+     * the primary selection pass; each advance re-selects the SAME target with
+     * expanded scan bounds. Durable so a crash-resume re-enters at the same stage.
+     */
+    fallback_stage: number;
     lastError: string | null;
     createdAt: string;
     updatedAt: string;
@@ -131,6 +137,9 @@ export declare class SlotRepository extends BaseRepository {
     releaseCellWork(slotId: string, targetId: string, workId: string): boolean;
     /** Explicit operator action: forget the locked work so a re-run picks another candidate. */
     clearCellWork(slotId: string, targetId: string): void;
+    /** Durable candidate-fallback bookkeeping (§schedule-recovery). */
+    bumpFallbackStage(slotId: string, targetId: string, reason: string): number;
+    cellFallbackStage(slotId: string, targetId: string): number;
     setCellStatus(slotId: string, targetId: string, status: CellStatus, error?: string): void;
     /**
      * Transition a cell with FSM validation. Never downgrades a confirmed cell;

package/dist/storage/repositories/SlotRepository.js

@@ -198,6 +198,28 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
          WHERE slot_id = @slotId AND target_id = @targetId`)
             .run({ slotId, targetId });
     }
+    /** Durable candidate-fallback bookkeeping (§schedule-recovery). */
+    bumpFallbackStage(slotId, targetId, reason) {
+        const item = this.db
+            .prepare(`SELECT fallback_stage FROM schedule_slot_items WHERE slot_id = ? AND target_id = ?`)
+            .get(slotId, targetId);
+        const stage = Number(item?.fallback_stage ?? 0);
+        this.db
+            .prepare(`UPDATE schedule_slot_items
+            SET fallback_stage = ?, last_error = ?,
+                status = 'pending',
+                updated_at = CURRENT_TIMESTAMP,
+                completed_at = NULL
+          WHERE slot_id = ? AND target_id = ?`)
+            .run(stage + 1, String(reason).slice(0, 400), slotId, targetId);
+        return stage + 1;
+    }
+    cellFallbackStage(slotId, targetId) {
+        const item = this.db
+            .prepare(`SELECT fallback_stage FROM schedule_slot_items WHERE slot_id = ? AND target_id = ?`)
+            .get(slotId, targetId);
+        return Number(item?.fallback_stage ?? 0);
+    }
     setCellStatus(slotId, targetId, status, error) {
         const terminal = status === 'submitted' ||
             status === 'no_candidate' ||
@@ -379,6 +401,7 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
             workType: row.work_type,
             status: row.status,
             attemptCount: row.attempt_count,
+            fallback_stage: Number(row.fallback_stage ?? 0),
             lastError: row.last_error,
             createdAt: row.created_at,
             updatedAt: row.updated_at,

package/dist/utils/config-validator-unified.js

@@ -261,6 +261,20 @@ class ConfigValidator {
                     });
                 }
             }
+            if (delivery.scheduleOutcomeUrl && !/\$\{[A-Za-z_][A-Za-z0-9_]*\}/.test(delivery.scheduleOutcomeUrl)) {
+                try {
+                    const url = new URL(delivery.scheduleOutcomeUrl);
+                    if (!['http:', 'https:'].includes(url.protocol))
+                        throw new Error('unsupported protocol');
+                }
+                catch {
+                    errors.push({
+                        code: 'CONFIG_VALIDATION_DELIVERY_SCHEDULE_OUTCOME_URL_INVALID',
+                        field: `${prefix}.scheduleOutcomeUrl`,
+                        message: `Delivery target '${name}': scheduleOutcomeUrl must be valid HTTP or HTTPS`,
+                    });
+                }
+            }
             if (delivery.readinessUrl && !/\$\{[A-Za-z_][A-Za-z0-9_]*\}/.test(delivery.readinessUrl)) {
                 try {
                     const url = new URL(delivery.readinessUrl);

package/dist/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BUILD = void 0;
 // GENERATED by scripts/write-version.js — do not edit manually.
-exports.BUILD = { version: '2.20.2', commit: 'cdaedd018e4d' };
+exports.BUILD = { version: '2.20.3', commit: '6ebffc579194' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

@@ -1,6 +1,6 @@
 {
   "type": "commonjs",
   "name": "pixivflow-webui-backend",
-  "version": "2.20.2",
+  "version": "2.20.3",
   "description": "PixivFlow WebUI Backend - CommonJS module"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixivflow",
-  "version": "2.20.2",
+  "version": "2.20.3",
   "description": "🎨 智能的 Pixiv 自动化下载工具 - 支持批量下载插画和小说、定时任务、Docker部署 | Intelligent Pixiv Automation Downloader with batch download, scheduler, and Docker support",
   "repository": {
     "type": "git",