pixivflow 3.0.1 → 3.0.2

package/dist/cli/fatalError.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handles fatal errors, prints user-friendly messages, and exits the process.
+ *
+ * Failure Contract (Deploy `AGENTS.md` §25): a startup failure must be both
+ * human-readable *and* machine-readable. The human text is printed here; the
+ * structured log carries `stage` and the **error object** — never
+ * `error.message` alone, because that drops the contract fields a
+ * `PixivFlowError` subclass owns (`code`, `statusCode`, `cause`), which is the
+ * same class of defect as a log line rendered as `"error":{}`.
+ */
+export declare function handleFatalError(error: unknown, exit?: (code: number) => void): void;
+//# sourceMappingURL=fatalError.d.ts.map

package/dist/cli/fatalError.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleFatalError = handleFatalError;
+const logger_1 = require("../logger");
+const errors_1 = require("../utils/errors");
+/**
+ * Handles fatal errors, prints user-friendly messages, and exits the process.
+ *
+ * Failure Contract (Deploy `AGENTS.md` §25): a startup failure must be both
+ * human-readable *and* machine-readable. The human text is printed here; the
+ * structured log carries `stage` and the **error object** — never
+ * `error.message` alone, because that drops the contract fields a
+ * `PixivFlowError` subclass owns (`code`, `statusCode`, `cause`), which is the
+ * same class of defect as a log line rendered as `"error":{}`.
+ */
+function handleFatalError(error, exit = (code) => process.exit(code)) {
+    if (error instanceof errors_1.ConfigError) {
+        console.error(`\n❌ Configuration Error: ${error.message}\n`);
+        logger_1.logger.error('Configuration error', { stage: 'application.startup', error });
+    }
+    else if (error instanceof errors_1.AuthenticationError) {
+        console.error('\n❌ Authentication Error');
+        console.error('════════════════════════════════════════════════════════════════');
+        console.error(error.message);
+        console.error('');
+        console.error('💡 Your refresh token may have expired or is invalid.');
+        console.error('   Please login again to get a new refresh token:');
+        console.error('');
+        console.error('   • Interactive login:  pixivflow login');
+        console.error('   • Headless login:     pixivflow login-headless');
+        console.error('════════════════════════════════════════════════════════════════\n');
+        logger_1.logger.error('Authentication failed', { stage: 'application.startup', error });
+    }
+    else {
+        logger_1.logger.error('Fatal error during application startup', {
+            stage: 'application.startup',
+            error: error instanceof Error ? error : String(error),
+        });
+        // Even an unrecognised failure must say something on the console; the log
+        // line alone is invisible to the operator who ran the command.
+        console.error(`\n❌ ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+    exit(1);
+}
+//# sourceMappingURL=fatalError.js.map

package/dist/index.js

@@ -7,36 +7,9 @@ const CommandRegistry_1 = require("./commands/CommandRegistry");
 const CommandResultRenderer_1 = require("./commands/CommandResultRenderer");
 const commands_1 = require("./commands");
 const ArgumentParser_1 = require("./cli/ArgumentParser");
+const fatalError_1 = require("./cli/fatalError");
 const errors_1 = require("./utils/errors");
 const schedules_1 = require("./scheduler/schedules");
-/**
- * Handles fatal errors, prints user-friendly messages, and exits the process.
- */
-function handleFatalError(error) {
-    if (error instanceof errors_1.ConfigError) {
-        console.error(`\n❌ Configuration Error: ${error.message}\n`);
-        logger_1.logger.error('Configuration error', { error: error.message });
-    }
-    else if (error instanceof errors_1.AuthenticationError) {
-        console.error('\n❌ Authentication Error');
-        console.error('════════════════════════════════════════════════════════════════');
-        console.error(error.message);
-        console.error('');
-        console.error('💡 Your refresh token may have expired or is invalid.');
-        console.error('   Please login again to get a new refresh token:');
-        console.error('');
-        console.error('   • Interactive login:  pixivflow login');
-        console.error('   • Headless login:     pixivflow login-headless');
-        console.error('════════════════════════════════════════════════════════════════\n');
-        logger_1.logger.error('Authentication failed', { error: error.message });
-    }
-    else {
-        logger_1.logger.error('Fatal error during application startup', {
-            error: error instanceof Error ? error.stack ?? error.message : String(error),
-        });
-    }
-    process.exit(1);
-}
 /**
  * Executes the given command.
  */
@@ -106,10 +79,16 @@ async function executeCommand(registry, commandName, context, args) {
         }
     }
     catch (error) {
+        // Pass the error itself: the logger expands it into
+        // `{name, message, stack, cause, …contract fields}`. A pre-formatted
+        // `error.stack` string dropped the `code` an operator greps for.
         logger_1.logger.error('Unexpected error during command execution', {
             command: commandName,
-            error: error instanceof Error ? error.stack ?? error.message : String(error),
+            stage: 'command.execute',
+            retryable: false,
+            error: error instanceof Error ? error : String(error),
         });
+        console.error((0, CommandResultRenderer_1.formatCommandFailure)({ error: error instanceof Error ? error : undefined }, commandName));
         process.exit(1);
     }
 }
@@ -125,15 +104,22 @@ async function executeDefaultBehavior(context, args) {
     try {
         const result = await command.execute(context, args);
         if (!result.success) {
-            logger_1.logger.error('Default command execution failed', { command: commandName, error: result.error });
-            process.exit(1);
+            logger_1.logger.error('Default command execution failed', {
+                command: commandName,
+                stage: 'command.execute',
+                reason: (0, CommandResultRenderer_1.commandFailureReason)(result, commandName),
+                retryable: false,
+                error: result.error,
+            });
+            console.error((0, CommandResultRenderer_1.formatCommandFailure)(result, commandName));
+            process.exit(result.exitCode ?? 1);
         }
         if (commandName === 'download') {
             process.exit(0);
         }
     }
     catch (error) {
-        handleFatalError(error);
+        (0, fatalError_1.handleFatalError)(error);
     }
 }
 /**
@@ -175,7 +161,7 @@ async function bootstrap() {
         config = (0, config_1.loadConfig)(configPath, isLoginCommand || isTokenOptional || !commandName);
     }
     catch (error) {
-        return handleFatalError(error);
+        return (0, fatalError_1.handleFatalError)(error);
     }
     const context = { config, logger: logger_1.logger, configPath };
     // --- Command execution ---
@@ -186,5 +172,5 @@ async function bootstrap() {
         await executeDefaultBehavior(context, commandArgs);
     }
 }
-bootstrap().catch(handleFatalError);
+bootstrap().catch(fatalError_1.handleFatalError);
 //# sourceMappingURL=index.js.map

package/dist/logger.js

@@ -13,17 +13,31 @@ const ctxStore = new node_async_hooks_1.AsyncLocalStorage();
  * non-enumerable — so a structured line carrying an error used to say
  * `"error":{}` and hide the failing stage (the exact shape that made
  * `pixivflow reconcile` undiagnosable in production). Errors are expanded
- * explicitly, `cause` included.
+ * explicitly, `cause` included, and every own enumerable field is kept:
+ * `PixivFlowError` subclasses carry the machine-readable contract there
+ * (`code`, `statusCode`, `url`, `isRateLimit`, `waitTime`, `itemId`,
+ * `itemType`), which is what the deploy Failure Contract requires an operator
+ * to be able to grep.
  */
 function serializeLogValue(value) {
     return JSON.stringify(value, (_key, item) => {
         if (item instanceof Error) {
-            return {
+            const serialized = {
                 name: item.name,
                 message: item.message,
-                ...(item.stack ? { stack: item.stack } : {}),
-                ...(item.cause !== undefined ? { cause: item.cause } : {}),
             };
+            for (const key of Object.keys(item)) {
+                if (!(key in serialized)) {
+                    serialized[key] = item[key];
+                }
+            }
+            if (item.stack) {
+                serialized.stack = item.stack;
+            }
+            if (item.cause !== undefined) {
+                serialized.cause = item.cause;
+            }
+            return serialized;
         }
         return item;
     });

package/dist/package.json

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

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: '3.0.1', commit: '33362ac35c11' };
+exports.BUILD = { version: '3.0.2', commit: 'a0e5f0be1522' };
 //# sourceMappingURL=version.js.map

package/dist/webui/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pixivflow",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "🎨 Pixiv 下载、筛选与自动收集工具 - 批量下载插画和小说、按标签/热度/日期筛选、定时任务与可靠 HTTP 交付 | Pixiv downloader and automation toolkit with filtering, scheduling and reliable HTTP delivery",
   "repository": {
     "type": "git",