pixivflow 2.20.5 → 2.22.0

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

@@ -29,6 +29,15 @@ export interface SlotRecord {
     manualRequestId: string | null;
     /** Opaque caller correlation (review chain / review id); null unless manual. */
     correlationId: string | null;
+    /**
+     * Request UUID of a remote MANUAL RECOVERY run (§manual-recovery); null for
+     * scheduled occurrences and review refetches. A recovery slot re-runs the
+     * failed target(s) under a per-occurrence recovery policy and reports its
+     * outcome through the schedule-outcome channel.
+     */
+    recoveryRequestId: string | null;
+    /** Recovery policy preset ('normal'|'relaxed'); null for non-recovery slots. */
+    recoveryMode: string | null;
 }
 export interface SlotItemRecord {
     id: number;
@@ -45,6 +54,14 @@ export interface SlotItemRecord {
      */
     fallback_stage: number;
     lastError: string | null;
+    /**
+     * Normalized terminal failure reason code (§terminal-reason) — one of the
+     * stable codes in TargetOutcome's failure taxonomy. Null for non-terminal
+     * cells or successful submissions.
+     */
+    terminalReasonCode: string | null;
+    /** User-facing business message for the terminal reason. */
+    terminalReasonMessage: string | null;
     createdAt: string;
     updatedAt: string;
     completedAt: string | null;
@@ -61,6 +78,8 @@ export interface SlotItemRecord {
 export declare class SlotRepository extends BaseRepository {
     /** Exact manual request/target lookup for authenticated convergence checks. */
     findManualSlot(requestId: string, targetId: string): SlotRecord | null;
+    /** Exact manual RECOVERY request/target lookup (§manual-recovery). */
+    findRecoverySlot(requestId: string, targetId: string): SlotRecord | null;
     /**
      * Fetch an existing slot or create it. On creation the schedule's target
      * membership is snapshotted (target_ids); a later config reload never mutates
@@ -81,6 +100,10 @@ export declare class SlotRepository extends BaseRepository {
         manualRequestId?: string | null;
         /** Opaque caller correlation recorded with a manual slot. */
         correlationId?: string | null;
+        /** Manual recovery request UUID (opens a `recover-` slot). */
+        recoveryRequestId?: string | null;
+        /** Manual recovery policy preset ('normal' | 'relaxed'). */
+        recoveryMode?: string | null;
     }): {
         slot: SlotRecord;
         created: boolean;
@@ -143,6 +166,12 @@ export declare class SlotRepository extends BaseRepository {
     bumpFallbackStage(slotId: string, targetId: string, reason: string): number;
     cellFallbackStage(slotId: string, targetId: string): number;
     setCellStatus(slotId: string, targetId: string, status: CellStatus, error?: string): void;
+    /**
+     * Persist the normalized terminal failure reason for a cell (§terminal-reason).
+     * Idempotent; a retried recovery/rollup only ever overwrites with the same or
+     * a later reasoned verdict.
+     */
+    setCellTerminalReason(slotId: string, targetId: string, code: string, message: string): void;
     /**
      * Transition a cell with FSM validation. Never downgrades a confirmed cell;
      * an illegal transition throws rather than silently corrupting state.

package/dist/storage/repositories/SlotRepository.js

@@ -17,6 +17,11 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
         const rows = this.db.prepare(`SELECT * FROM schedule_slots WHERE manual_request_id = ?`).all(requestId);
         return rows.map((row) => this.toSlot(row)).find((slot) => slot.targetIds.includes(targetId)) ?? null;
     }
+    /** Exact manual RECOVERY request/target lookup (§manual-recovery). */
+    findRecoverySlot(requestId, targetId) {
+        const rows = this.db.prepare(`SELECT * FROM schedule_slots WHERE recovery_request_id = ?`).all(requestId);
+        return rows.map((row) => this.toSlot(row)).find((slot) => slot.targetIds.includes(targetId)) ?? null;
+    }
     /**
      * Fetch an existing slot or create it. On creation the schedule's target
      * membership is snapshotted (target_ids); a later config reload never mutates
@@ -26,10 +31,12 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
     getOrCreateSlot(id, data) {
         const insert = this.db.prepare(`INSERT INTO schedule_slots
          (id, schedule_id, occurrence_at, occurrence_date, occurrence_label, timezone, target_ids,
-          status, trigger_source, slot_date, slot_name, manual_request_id, correlation_id)
+          status, trigger_source, slot_date, slot_name, manual_request_id, correlation_id,
+          recovery_request_id, recovery_mode)
        VALUES
          (@id, @scheduleId, @occurrenceAt, @occurrenceDate, @occurrenceLabel, @timezone, @targetIds,
-          'pending', @triggerSource, @slotDate, @slotName, @manualRequestId, @correlationId)
+          'pending', @triggerSource, @slotDate, @slotName, @manualRequestId, @correlationId,
+          @recoveryRequestId, @recoveryMode)
        ON CONFLICT(id) DO NOTHING`);
         const info = insert.run({
             id,
@@ -44,6 +51,8 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
             slotName: data.slotName ?? '',
             manualRequestId: data.manualRequestId ?? null,
             correlationId: data.correlationId ?? null,
+            recoveryRequestId: data.recoveryRequestId ?? null,
+            recoveryMode: data.recoveryMode ?? null,
         });
         const created = info.changes > 0;
         return { slot: this.getSlot(id), created };
@@ -244,6 +253,19 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
             .prepare(`UPDATE schedule_slot_items SET ${sets.join(', ')} WHERE slot_id = @slotId AND target_id = @targetId`)
             .run({ slotId, targetId, status, error: error ?? null });
     }
+    /**
+     * Persist the normalized terminal failure reason for a cell (§terminal-reason).
+     * Idempotent; a retried recovery/rollup only ever overwrites with the same or
+     * a later reasoned verdict.
+     */
+    setCellTerminalReason(slotId, targetId, code, message) {
+        this.db
+            .prepare(`UPDATE schedule_slot_items
+         SET terminal_reason_code = @code, terminal_reason_message = @message,
+             updated_at = CURRENT_TIMESTAMP
+         WHERE slot_id = @slotId AND target_id = @targetId`)
+            .run({ slotId, targetId, code: code.slice(0, 64), message: message.slice(0, 400) });
+    }
     /**
      * Transition a cell with FSM validation. Never downgrades a confirmed cell;
      * an illegal transition throws rather than silently corrupting state.
@@ -402,6 +424,8 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
             heartbeatAt: row.heartbeat_at ?? null,
             manualRequestId: row.manual_request_id ?? null,
             correlationId: row.correlation_id ?? null,
+            recoveryRequestId: row.recovery_request_id ?? null,
+            recoveryMode: row.recovery_mode ?? null,
         };
     }
     toItem(row) {
@@ -415,6 +439,8 @@ class SlotRepository extends BaseRepository_1.BaseRepository {
             attemptCount: row.attempt_count,
             fallback_stage: Number(row.fallback_stage ?? 0),
             lastError: row.last_error,
+            terminalReasonCode: row.terminal_reason_code ?? null,
+            terminalReasonMessage: row.terminal_reason_message ?? null,
             createdAt: row.created_at,
             updatedAt: row.updated_at,
             completedAt: row.completed_at,

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.5', commit: '9352c0253571' };
+exports.BUILD = { version: '2.22.0', commit: 'e6cd6211dba7' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pixivflow",
-  "version": "2.20.5",
-  "description": "🎨 智能的 Pixiv 自动化下载工具 - 支持批量下载插画和小说、定时任务、Docker部署 | Intelligent Pixiv Automation Downloader with batch download, scheduler, and Docker support",
+  "version": "2.22.0",
+  "description": "🎨 Pixiv 下载、筛选与自动收集工具 - 批量下载插画和小说、按标签/热度/日期筛选、定时任务与可靠 HTTP 交付 | Pixiv downloader and automation toolkit with filtering, scheduling and reliable HTTP delivery",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/redtidev1918/PixivFlow.git"