ee-core 5.0.0-beta.2 → 5.0.0-beta.5

package/dist/esm/jobs/child/app.js

@@ -1,28 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @module jobs/child/app
+ * @description Child process entry application. Runs in child processes created by child_process.fork(),
+ * responsible for receiving messages from the main process and executing corresponding task files.
+ *
+ * Child process lifecycle:
+ * 1. Main process forks a child process and loads this module
+ * 2. Child process receives config from main process via processArgs, avoiding filesystem config loading
+ * 3. Child process listens for message events, waiting for main process instructions
+ * 4. Upon receiving a run command, loads and executes the task file
+ * 5. Class-type task files: instantiated and cached on first execution, reused thereafter
+ * 6. Function-type task files: called directly on each execution
+ *
+ * Note: Child processes are independent from the main process and must load exception handling separately (loadException)
+ */
 const type_check_js_1 = require("../../utils/type_check.js");
 const index_js_1 = require("../../exception/index.js");
-const index_js_2 = require("../../loader/index.js");
-const index_js_3 = require("../../log/index.js");
-const index_js_4 = require("../../core/utils/index.js");
+const index_js_2 = require("../../config/index.js");
+const index_js_3 = require("../../loader/index.js");
+const index_js_4 = require("../../log/index.js");
+const index_js_5 = require("../../core/utils/index.js");
+const channel_js_1 = require("../../const/channel.js");
+// Receive config from main process via processArgs, so child process
+// doesn't need to load config from filesystem (which may fail in bundled mode)
+try {
+    const args = JSON.parse(process.argv[2] || '{}');
+    if (args.eeConfig) {
+        (0, index_js_2.setConfig)(args.eeConfig);
+    }
+}
+catch {
+    // If config can't be parsed, child process will use default config
+}
+// Child process must independently load exception handling
 (0, index_js_1.loadException)();
+/** Supported command list */
 const commands = ['run'];
+/**
+ * ChildApp - Child process application
+ *
+ * Runs in the child process, receives run commands from the main process to execute task files.
+ * Class-type task instances are cached in jobMap for reuse.
+ */
 class ChildApp {
     constructor() {
         this._initEvents();
         this.jobMap = new Map();
     }
     /**
-     * 初始化事件监听
+     * Initialize event listeners
+     *
+     * Listen for main process messages and child process exit events.
      */
     _initEvents() {
         process.on('message', this._handleMessage.bind(this));
         process.once('exit', (code) => {
-            index_js_3.coreLogger.info(`[jobs/child] received a exit from main-process, code:${code}, pid:${process.pid}`);
+            index_js_4.coreLogger.info(`[jobs/child] received a exit from main-process, code:${code}, pid:${process.pid}`);
         });
     }
     /**
-     * 监听消息
+     * Handle main process messages
+     *
+     * Only processes commands in the commands list, ignoring unknown commands.
      */
     _handleMessage(m) {
         if (commands.indexOf(m.cmd) === -1) {
@@ -35,37 +75,58 @@ class ChildApp {
             default:
                 break;
         }
-        index_js_3.coreLogger.info(`[jobs/child] received a message from main-process, message: ${JSON.stringify(m)}`);
+        index_js_4.coreLogger.info(`[jobs/child] received a message from main-process, message: ${JSON.stringify(m)}`);
     }
     /**
-     * 运行脚本
+     * Run a task
+     *
+     * Executes different logic based on the task file's export type:
+     * - Class/bytecode class: instantiated and cached on first run (jobMap), reused thereafter
+     *   - If jobFunc is specified: call the specified method on the instance
+     *   - Otherwise call the instance's handle() method (default entry)
+     * - Plain function: called directly with jobParams
+     *
+     * @param msg - Task message containing file path, parameters, and function name
      */
     run(msg = { mid: '', cmd: '' }) {
         const { jobPath, jobParams, jobFunc, jobFuncParams } = msg;
         if (!jobPath)
             return;
-        const mod = (0, index_js_2.requireFile)(jobPath);
-        if ((0, type_check_js_1.isClass)(mod) || (0, index_js_4.isBytecodeClass)(mod)) {
-            let instance;
-            if (!this.jobMap.has(jobPath)) {
-                instance = new mod(...(jobParams || []));
-                this.jobMap.set(jobPath, instance);
+        try {
+            const mod = (0, index_js_3.requireFile)(jobPath);
+            if ((0, type_check_js_1.isClass)(mod) || (0, index_js_5.isBytecodeClass)(mod)) {
+                let instance;
+                if (!this.jobMap.has(jobPath)) {
+                    // First execution: instantiate and cache
+                    instance = new mod(...(jobParams || []));
+                    this.jobMap.set(jobPath, instance);
+                }
+                else {
+                    // Subsequent execution: reuse cached instance
+                    instance = this.jobMap.get(jobPath);
+                }
+                // Call the specified method or default handle method
+                // Note: Use typeof check instead of hasOwnProperty to support instance and prototype methods
+                if (jobFunc && typeof instance[jobFunc] === 'function') {
+                    instance[jobFunc](...(jobFuncParams || []));
+                }
+                else if (typeof instance.handle === 'function') {
+                    instance.handle(...(jobParams || []));
+                }
             }
-            else {
-                instance = this.jobMap.get(jobPath);
-            }
-            // 如果指定了函数名，则调用指定的函数
-            if (jobFunc && typeof instance[jobFunc] === 'function') {
-                instance[jobFunc](...(jobFuncParams || []));
-            }
-            else if (typeof instance.handle === 'function') {
-                instance.handle(...(jobParams || []));
+            else if ((0, type_check_js_1.isFunction)(mod)) {
+                mod(jobParams);
             }
         }
-        else if ((0, type_check_js_1.isFunction)(mod)) {
-            mod(jobParams);
+        catch (e) {
+            index_js_4.coreLogger.error('[jobs/child] run error:', e);
+            // Propagate error back to main process so it's not silently lost
+            if (process.send) {
+                process.send({ channel: channel_js_1.Processes.showException, data: String(e) });
+            }
         }
     }
 }
+// Create ChildApp instance when child process starts
 new ChildApp();
 //# sourceMappingURL=app.js.map

package/dist/esm/jobs/child/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/jobs/child/app.ts"],"names":[],"mappings":";;AAAA,6DAAgE;AAChE,uDAAyD;AACzD,oDAAoD;AACpD,iDAAgD;AAChD,wDAA4D;AAG5D,IAAA,wBAAa,GAAE,CAAC;AAEhB,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC;AAEzB,MAAM,QAAQ;IAGZ;QACE,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,EAAE;YAC3C,qBAAU,CAAC,IAAI,CAAC,wDAAwD,IAAI,SAAS,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtG,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,CAAa;QAC1B,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACnC,OAAO;QACT,CAAC;QACD,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;YACd,KAAK,KAAK;gBACR,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACZ,MAAM;YACR;gBACE,MAAM;QACV,CAAC;QACD,qBAAU,CAAC,IAAI,CAAC,+DAA+D,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAkB,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACxC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC;QAC3D,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,MAAM,GAAG,GAAG,IAAA,sBAAW,EAAC,OAAO,CAAC,CAAC;QACjC,IAAI,IAAA,uBAAO,EAAC,GAAG,CAAC,IAAI,IAAA,0BAAe,EAAC,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,QAAiC,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9B,QAAQ,GAAG,IAAK,GAA2D,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;gBAClG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAA4B,CAAC;YACjE,CAAC;YAED,oBAAoB;YACpB,IAAI,OAAO,IAAI,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,UAAU,EAAE,CAAC;gBACtD,QAAQ,CAAC,OAAO,CAAqC,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;YACnF,CAAC;iBAAM,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;aAAM,IAAI,IAAA,0BAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,GAAuC,CAAC,SAAS,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;CACF;AAED,IAAI,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../../../src/jobs/child/app.ts"],"names":[],"mappings":"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"}

package/dist/esm/jobs/child/index.d.ts

@@ -6,23 +6,23 @@ export declare class ChildJob extends EventEmitter {
     config: JobsConfig;
     constructor();
     /**
-     * 初始化监听
+     * Initialize event listeners
      */
     _initEvents(): void;
     /**
-     * 执行一个job文件
+     * Execute a job file
      */
     exec(filepath: string, params?: Record<string, unknown>, opt?: JobProcessOptions): JobProcess;
     /**
-     * 创建子进程
+     * Create a child process
      */
     createProcess(opt?: JobProcessOptions): JobProcess;
     /**
-     * 获取当前pids
+     * Get current PIDs
      */
     getPids(): string[];
     /**
-     * 异步执行一个job文件
+     * Asynchronously execute a job file
      */
     execPromise(filepath: string, params?: Record<string, unknown>, opt?: JobProcessOptions): Promise<JobProcess>;
 }

package/dist/esm/jobs/child/index.js

@@ -18,7 +18,7 @@ class ChildJob extends events_1.EventEmitter {
         this._initEvents();
     }
     /**
-     * 初始化监听
+     * Initialize event listeners
      */
     _initEvents() {
         this.on(channel_js_1.Events.childProcessExit, (data) => {
@@ -33,7 +33,7 @@ class ChildJob extends events_1.EventEmitter {
         });
     }
     /**
-     * 执行一个job文件
+     * Execute a job file
      */
     exec(filepath, params = {}, opt = {}) {
         const jobPath = (0, index_js_1.getFullpath)(filepath);
@@ -43,7 +43,7 @@ class ChildJob extends events_1.EventEmitter {
         return proc;
     }
     /**
-     * 创建子进程
+     * Create a child process
      */
     createProcess(opt = {}) {
         const options = {
@@ -62,13 +62,13 @@ class ChildJob extends events_1.EventEmitter {
         return proc;
     }
     /**
-     * 获取当前pids
+     * Get current PIDs
      */
     getPids() {
         return Object.keys(this.jobs);
     }
     /**
-     * 异步执行一个job文件
+     * Asynchronously execute a job file
      */
     async execPromise(filepath, params = {}, opt = {}) {
         return this.exec(filepath, params, opt);

package/dist/esm/jobs/child/jobProcess.d.ts

@@ -1,34 +1,102 @@
 import { EventEmitter } from 'events';
 import { type ChildProcess, type ForkOptions } from 'child_process';
 import type { JobsConfig, MessageData } from '../../types/index.js';
+/** Options when creating a JobProcess */
 export interface JobProcessOptions {
+    /** Arguments object passed to the child process */
     processArgs?: Record<string, unknown>;
+    /** Fork options (cwd, env, stdio, etc.) */
     processOptions?: ForkOptions;
+    [key: string]: unknown;
 }
+/** Message format: Main process -> Child process */
 export interface JobMessage {
+    /** Message ID */
     mid: string;
+    /** Command (e.g. 'run') */
     cmd: string;
+    /** Task file path */
     jobPath?: string;
+    /** Task constructor arguments */
     jobParams?: unknown[];
+    /** Instance method name to call */
     jobFunc?: string;
+    /** Instance method arguments */
     jobFuncParams?: unknown[];
 }
+/** Message format: Child process -> Main process */
 export interface ProcessMessage extends MessageData {
+    /** Message receiver type */
     eventReceiver: string;
 }
+/**
+ * JobProcess - Child process manager
+ *
+ * Encapsulates the complete logic of forking a child process:
+ * 1. Determine app.js entry path (child process entry within node_modules/ee-core)
+ * 2. Configure working directory and environment variables
+ * 3. Fork the child process and register event listeners
+ * 4. Provide dispatch() and callFunc() for sending messages
+ * 5. Provide kill() for terminating the process
+ */
 export declare class JobProcess {
+    /** In-process event emitter (forkProcess-level messages) */
     emitter: EventEmitter;
+    /** Host event emitter (ChildJob/ChildPoolJob, childJob-level messages) */
     host: EventEmitter;
+    /** Arguments array passed to the child process */
     args: string[];
+    /** Whether the child process is in a sleeping state */
     sleeping: boolean;
+    /** Child process object returned by child_process.fork() */
     child: ChildProcess;
+    /** Child process PID */
     pid: number | undefined;
+    /** Task configuration */
     config: JobsConfig;
     constructor(host: EventEmitter, opt?: JobProcessOptions, config?: JobsConfig);
+    /**
+     * Initialize child process event listeners
+     *
+     * Listens for three types of events:
+     * - message: Process messages from the child process (exception display, business message forwarding)
+     * - exit: Child process exited, notify host to clean up
+     * - error: Child process error, notify host to clean up
+     */
     _init(): void;
+    /**
+     * Dispatch messages to different event emitters based on eventReceiver
+     *
+     * - forkProcess: send only to in-process emitter
+     * - childJob: send only to host emitter
+     * - all / others: send to both
+     */
     _eventEmit(m: ProcessMessage): void;
+    /**
+     * Send a dispatch message to the child process
+     *
+     * @param cmd - Command (e.g. 'run')
+     * @param jobPath - Task file path
+     * @param params - Task parameters
+     */
     dispatch(cmd: string, jobPath?: string, ...params: unknown[]): void;
+    /**
+     * Call a specified method on the task instance in the child process
+     *
+     * Resolves the task file path, then sends a run command with the specified function name.
+     *
+     * @param jobPath - Task file path (relative paths are resolved to absolute paths)
+     * @param funcName - Method name to call
+     * @param params - Method arguments
+     */
     callFunc(jobPath?: string, funcName?: string, ...params: unknown[]): void;
+    /**
+     * Terminate the child process
+     *
+     * First sends SIGINT for graceful exit, then sends SIGKILL to force termination after timeout.
+     *
+     * @param timeout - Timeout in milliseconds to wait for graceful exit
+     */
     kill(timeout?: number): void;
 }
 //# sourceMappingURL=jobProcess.d.ts.map

package/dist/esm/jobs/child/jobProcess.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobProcess.d.ts","sourceRoot":"","sources":["../../../../src/jobs/child/jobProcess.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAQ,KAAK,YAAY,EAAqB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAQ7F,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAwB,MAAM,sBAAsB,CAAC;AAE1F,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,cAAc,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,UAAU;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;gBAEP,IAAI,EAAE,YAAY,EAAE,GAAG,GAAE,iBAAsB,EAAE,MAAM,GAAE,UAAkC;IAsCvG,KAAK,IAAI,IAAI;IA8Bb,UAAU,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI;IAenC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAe/D,QAAQ,CAAC,OAAO,SAAK,EAAE,QAAQ,SAAK,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAejE,IAAI,CAAC,OAAO,SAAO,GAAG,IAAI;CAO3B"}
+{"version":3,"file":"jobProcess.d.ts","sourceRoot":"","sources":["../../../../src/jobs/child/jobProcess.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAQ,KAAK,YAAY,EAAqB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAS7F,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAwB,MAAM,sBAAsB,CAAC;AAE1F,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,2CAA2C;IAC3C,cAAc,CAAC,EAAE,WAAW,CAAC;IAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,qBAAa,UAAU;IACrB,4DAA4D;IAC5D,OAAO,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,IAAI,EAAE,YAAY,CAAC;IACnB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,KAAK,EAAE,YAAY,CAAC;IACpB,wBAAwB;IACxB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;gBAEP,IAAI,EAAE,YAAY,EAAE,GAAG,GAAE,iBAAsB,EAAE,MAAM,GAAE,UAAkC;IA2CvG;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI;IA6Cb;;;;;;OAMG;IACH,UAAU,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI;IAenC;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAY/D;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,SAAK,EAAE,QAAQ,SAAK,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI;IAcjE;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,SAAO,GAAG,IAAI;CAO3B"}

package/dist/esm/jobs/child/jobProcess.js

@@ -4,31 +4,58 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.JobProcess = void 0;
+/**
+ * @module jobs/child/jobProcess
+ * @description Child process manager. Encapsulates child_process.fork() creation and communication logic,
+ * providing the main process with the ability to create child processes, send messages, and terminate processes.
+ *
+ * Communication mechanism:
+ * - Main process sends JobMessage to child process via child.send()
+ * - Child process sends ProcessMessage to main process via process.send()
+ * - Messages are categorized by channel: showException (exception), sendToMain (business message)
+ * - Messages are dispatched by eventReceiver: childJob (global), forkProcess (per-process), all (both)
+ */
 const path_1 = __importDefault(require("path"));
 const events_1 = require("events");
 const child_process_1 = require("child_process");
 const serialize_javascript_1 = __importDefault(require("serialize-javascript"));
 const index_js_1 = require("../../log/index.js");
 const index_js_2 = require("../../ps/index.js");
+const index_js_3 = require("../../config/index.js");
 const channel_js_1 = require("../../const/channel.js");
 const helper_js_1 = require("../../utils/helper.js");
-const index_js_3 = require("../../loader/index.js");
+const index_js_4 = require("../../loader/index.js");
 const extend_js_1 = require("../../utils/extend.js");
+/**
+ * JobProcess - Child process manager
+ *
+ * Encapsulates the complete logic of forking a child process:
+ * 1. Determine app.js entry path (child process entry within node_modules/ee-core)
+ * 2. Configure working directory and environment variables
+ * 3. Fork the child process and register event listeners
+ * 4. Provide dispatch() and callFunc() for sending messages
+ * 5. Provide kill() for terminating the process
+ */
 class JobProcess {
     constructor(host, opt = {}, config = { messageLog: false }) {
         let cwd = (0, index_js_2.getBaseDir)();
+        // Locate app.js entry: child process startup file within the ee-core package
         const currentFilePath = typeof __filename !== 'undefined' ? __filename : '';
         const appPath = path_1.default.join(path_1.default.dirname(currentFilePath), 'app.js');
-        // todo fork的cwd目录为什么要在app.asar外 ？
+        // After packaging, cwd must be outside app.asar (child processes need access to node_modules)
         if ((0, index_js_2.isPackaged)()) {
             cwd = path_1.default.join((0, index_js_2.getBaseDir)(), '..');
         }
         const defaultOptions = {
-            processArgs: {},
+            processArgs: {
+                type: 'childJob',
+                // Pass main process config to child process so it doesn't need to load from filesystem
+                eeConfig: (0, index_js_3.getConfig)(),
+            },
             processOptions: {
                 cwd,
                 env: (0, index_js_2.allEnv)(),
-                stdio: 'ignore', // pipe
+                stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
             },
         };
         const options = (0, extend_js_1.extend)(true, defaultOptions, opt);
@@ -37,26 +64,48 @@ class JobProcess {
         this.args = [];
         this.sleeping = false;
         this.config = config;
-        // 传递给子进程的参数
+        // Serialize arguments and pass them to the child process
         this.args.push(JSON.stringify(options.processArgs));
         this.child = (0, child_process_1.fork)(appPath, this.args, options.processOptions ?? {});
         this.pid = this.child.pid;
         this._init();
     }
+    /**
+     * Initialize child process event listeners
+     *
+     * Listens for three types of events:
+     * - message: Process messages from the child process (exception display, business message forwarding)
+     * - exit: Child process exited, notify host to clean up
+     * - error: Child process error, notify host to clean up
+     */
     _init() {
         const { messageLog } = this.config;
         this.child.on('message', (m) => {
             if (messageLog) {
                 index_js_1.coreLogger.info(`[jobs/child] received a message from child-process, message: ${(0, serialize_javascript_1.default)(m)}`);
             }
+            // Exception message: log it
             if (m.channel === channel_js_1.Processes.showException) {
                 index_js_1.coreLogger.error(`${m.data}`);
             }
-            // 收到子进程消息，转发到 event
+            // Business message: dispatch based on eventReceiver
             if (m.channel === channel_js_1.Processes.sendToMain) {
                 this._eventEmit(m);
             }
         });
+        // Capture child process stdout/stderr for debugging
+        const stdout = this.child.stdout;
+        const stderr = this.child.stderr;
+        if (stdout) {
+            stdout.on('data', (data) => {
+                index_js_1.coreLogger.info(`[jobs/child] stdout: ${data.toString().trim()}`);
+            });
+        }
+        if (stderr) {
+            stderr.on('data', (data) => {
+                index_js_1.coreLogger.error(`[jobs/child] stderr: ${data.toString().trim()}`);
+            });
+        }
         this.child.on('exit', (code, signal) => {
             const data = { pid: this.pid };
             this.host.emit(channel_js_1.Events.childProcessExit, data);
@@ -68,6 +117,13 @@ class JobProcess {
             index_js_1.coreLogger.error(`[jobs/child] received a error from child-process, error: ${err}, pid:${this.pid}`);
         });
     }
+    /**
+     * Dispatch messages to different event emitters based on eventReceiver
+     *
+     * - forkProcess: send only to in-process emitter
+     * - childJob: send only to host emitter
+     * - all / others: send to both
+     */
     _eventEmit(m) {
         switch (m.eventReceiver) {
             case channel_js_1.Receiver.forkProcess:
@@ -82,8 +138,14 @@ class JobProcess {
                 break;
         }
     }
+    /**
+     * Send a dispatch message to the child process
+     *
+     * @param cmd - Command (e.g. 'run')
+     * @param jobPath - Task file path
+     * @param params - Task parameters
+     */
     dispatch(cmd, jobPath = '', ...params) {
-        // 消息对象
         const mid = (0, helper_js_1.getRandomString)();
         const msg = {
             mid,
@@ -91,13 +153,19 @@ class JobProcess {
             jobPath,
             jobParams: params,
         };
-        // todo 是否会发生监听未完成时，接收不到消息？
-        // 发消息到子进程
         this.child.send(msg);
     }
+    /**
+     * Call a specified method on the task instance in the child process
+     *
+     * Resolves the task file path, then sends a run command with the specified function name.
+     *
+     * @param jobPath - Task file path (relative paths are resolved to absolute paths)
+     * @param funcName - Method name to call
+     * @param params - Method arguments
+     */
     callFunc(jobPath = '', funcName = '', ...params) {
-        const fullPath = (0, index_js_3.getFullpath)(jobPath);
-        // 消息对象
+        const fullPath = (0, index_js_4.getFullpath)(jobPath);
         const mid = (0, helper_js_1.getRandomString)();
         const msg = {
             mid,
@@ -108,6 +176,13 @@ class JobProcess {
         };
         this.child.send(msg);
     }
+    /**
+     * Terminate the child process
+     *
+     * First sends SIGINT for graceful exit, then sends SIGKILL to force termination after timeout.
+     *
+     * @param timeout - Timeout in milliseconds to wait for graceful exit
+     */
     kill(timeout = 1000) {
         this.child.kill('SIGINT');
         setTimeout(() => {

package/dist/esm/jobs/child/jobProcess.js.map

@@ -1 +1 @@
-{"version":3,"file":"jobProcess.js","sourceRoot":"","sources":["../../../../src/jobs/child/jobProcess.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"jobProcess.js","sourceRoot":"","sources":["../../../../src/jobs/child/jobProcess.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;;;;;GAUG;AACH,gDAAwB;AACxB,mCAAsC;AACtC,iDAA6F;AAC7F,gFAA6C;AAC7C,iDAAgD;AAChD,gDAAmE;AACnE,oDAAkD;AAClD,uDAAqE;AACrE,qDAAwD;AACxD,oDAAoD;AACpD,qDAA+C;AAkC/C;;;;;;;;;GASG;AACH,MAAa,UAAU;IAgBrB,YAAY,IAAkB,EAAE,MAAyB,EAAE,EAAE,SAAqB,EAAE,UAAU,EAAE,KAAK,EAAE;QACrG,IAAI,GAAG,GAAG,IAAA,qBAAU,GAAE,CAAC;QACvB,6EAA6E;QAC7E,MAAM,eAAe,GAAG,OAAO,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,MAAM,OAAO,GAAG,cAAI,CAAC,IAAI,CAAC,cAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,CAAC;QACnE,8FAA8F;QAC9F,IAAI,IAAA,qBAAU,GAAE,EAAE,CAAC;YACjB,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,IAAA,qBAAU,GAAE,EAAE,IAAI,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,cAAc,GAAsB;YACxC,WAAW,EAAE;gBACX,IAAI,EAAE,UAAU;gBAChB,uFAAuF;gBACvF,QAAQ,EAAE,IAAA,oBAAS,GAAE;aACtB;YACD,cAAc,EAAE;gBACd,GAAG;gBACH,GAAG,EAAE,IAAA,iBAAM,GAAE;gBACb,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAyB;aACjE;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,IAAA,kBAAM,EACpB,IAAI,EACJ,cAAc,EACd,GAAG,CACiB,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAG,IAAI,qBAAY,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,yDAAyD;QACzD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAEpD,IAAI,CAAC,KAAK,GAAG,IAAA,oBAAI,EAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;;;;;;OAOG;IACH,KAAK;QACH,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,CAAiB,EAAE,EAAE;YAC7C,IAAI,UAAU,EAAE,CAAC;gBACf,qBAAU,CAAC,IAAI,CAAC,gEAAgE,IAAA,8BAAS,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClG,CAAC;YAED,4BAA4B;YAC5B,IAAI,CAAC,CAAC,OAAO,KAAK,sBAAS,CAAC,aAAa,EAAE,CAAC;gBAC1C,qBAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChC,CAAC;YAED,oDAAoD;YACpD,IAAI,CAAC,CAAC,OAAO,KAAK,sBAAS,CAAC,UAAU,EAAE,CAAC;gBACvC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,oDAAoD;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACjC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACjC,qBAAU,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;gBACjC,qBAAU,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,MAAqB,EAAE,EAAE;YACnE,MAAM,IAAI,GAAyB,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAM,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC;YAC9C,qBAAU,CAAC,IAAI,CAAC,yDAAyD,IAAI,YAAY,MAAM,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACtH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YACpC,MAAM,IAAI,GAAyB,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;YAC/C,qBAAU,CAAC,KAAK,CAAC,4DAA4D,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACvG,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,CAAiB;QAC1B,QAAQ,CAAC,CAAC,aAAa,EAAE,CAAC;YACxB,KAAK,qBAAQ,CAAC,WAAW;gBACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBACnC,MAAM;YACR,KAAK,qBAAQ,CAAC,QAAQ;gBACpB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM;YACR;gBACE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBACnC,MAAM;QACV,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,GAAW,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,MAAiB;QACtD,MAAM,GAAG,GAAG,IAAA,2BAAe,GAAE,CAAC;QAC9B,MAAM,GAAG,GAAe;YACtB,GAAG;YACH,GAAG;YACH,OAAO;YACP,SAAS,EAAE,MAAM;SAClB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAmB,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,MAAiB;QACxD,MAAM,QAAQ,GAAG,IAAA,sBAAW,EAAC,OAAO,CAAC,CAAC;QAEtC,MAAM,GAAG,GAAG,IAAA,2BAAe,GAAE,CAAC;QAC9B,MAAM,GAAG,GAAe;YACtB,GAAG;YACH,GAAG,EAAE,KAAK;YACV,OAAO,EAAE,QAAQ;YACjB,OAAO,EAAE,QAAQ;YACjB,aAAa,EAAE,MAAM;SACtB,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAmB,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,GAAG,IAAI;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,OAAO;YAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7B,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;CACF;AA9LD,gCA8LC"}