target-supabase-sdk 0.1.8 → 0.2.0

package/dist/node/node.api.js

@@ -1,137 +1,100 @@
-import { CategoryTask, TaskStatus } from "../task/task.interface";
-import { createTarget, getPossibleTarget, updateTargetDetails } from "../core.api";
+import { createTarget, updateTargetDetails, validateWithSchema } from "../core.api";
 import { generateResponse } from "../core.interface";
-import { BaseValidator } from "../core.utils";
+import { createApiLogger } from "../shared/log";
+import { z } from "zod";
 import { CategoryNode, NodeStatus } from "./node.interface";
-export class PostListValidator extends BaseValidator {
-    requiredFields = [];
-    optionalFields = [];
-    constructor() {
-        super();
-        // Add custom
-        this.addCustomValidator((val) => {
-            return true;
-        });
-    }
+const NODE_STATUS_FIELD = "details->>status";
+const nodeIdSchema = z.string().trim().min(1);
+const traceIdSchema = z.string().trim().min(1).optional();
+// ─── Zod schemas ─────────────────────────────────────────────────────────────
+export const postRegisterNodeSchema = z.object({
+    traceId: traceIdSchema,
+});
+export const patchNodeHeartBeatSchema = z.object({
+    nodeId: nodeIdSchema,
+    traceId: traceIdSchema,
+});
+export const patchStopNodeSchema = z.object({
+    nodeId: nodeIdSchema,
+    traceId: traceIdSchema,
+});
+export const patchChangeNodeStatusSchema = z.object({
+    nodeId: nodeIdSchema,
+    status: z.nativeEnum(NodeStatus),
+    /** When set, UPDATE only if current status matches (optimistic lock). */
+    fromStatus: z.nativeEnum(NodeStatus).optional(),
+    traceId: traceIdSchema,
+});
+// ─── Optimistic lock helpers ─────────────────────────────────────────────────
+function lockOnNodeStatus(status) {
+    return [{ field: NODE_STATUS_FIELD, operator: "eq", value: status }];
 }
-export const postRegisterNode = async (payload) => {
+// ─── postRegisterNode ────────────────────────────────────────────────────────
+export const postRegisterNode = validateWithSchema(postRegisterNodeSchema, "postRegisterNodeSchema")(async (payload) => {
     return createTarget({
-        payload: payload,
-        validator: PostListValidator,
-        createFn: (validPayload) => {
+        payload,
+        createFn: () => {
             const details = {
                 manifestVersion: 0,
                 status: NodeStatus.READY,
                 lastHeartBeat: Date.now(),
             };
             return {
-                name: '',
+                name: "",
                 category: CategoryNode.NODE,
-                value: '',
+                value: "",
                 tagList: [],
                 details,
             };
         },
     });
-};
-export const patchNodeHeartBeat = async ({ nodeId }) => {
+});
+// ─── patchNodeHeartBeat ──────────────────────────────────────────────────────
+export const patchNodeHeartBeat = validateWithSchema(patchNodeHeartBeatSchema, "patchNodeHeartBeatSchema")(async ({ nodeId }) => {
     const lastHeartBeat = Date.now();
     await updateTargetDetails({
         id: nodeId,
-        updateFn: (details) => {
-            return {
-                ...details,
-                lastHeartBeat,
-            };
-        },
+        updateFn: (details) => ({
+            ...details,
+            lastHeartBeat,
+        }),
     });
     return generateResponse.success(lastHeartBeat);
-};
-export const patchStopNode = async ({ nodeId }) => {
+});
+// ─── patchStopNode ───────────────────────────────────────────────────────────
+export const patchStopNode = validateWithSchema(patchStopNodeSchema, "patchStopNodeSchema")(async ({ nodeId }) => {
     const lastHeartBeat = Date.now();
     // TODO 等待任務全部完成才下綫 應該先使用NodeStatus.DRAINING
     await updateTargetDetails({
         id: nodeId,
-        updateFn: (details) => {
-            return {
-                ...details,
-                lastHeartBeat,
-                status: NodeStatus.LOST,
-            };
-        },
+        updateFn: (details) => ({
+            ...details,
+            lastHeartBeat,
+            status: NodeStatus.LOST,
+        }),
     });
     return generateResponse.success(lastHeartBeat);
-};
-/**
- * Atomically claim one TODO task for this node.
- *
- * Flow: find a candidate (TODO + value in availableTaskList) → UPDATE with optimistic lock
- * (status must still be TODO) → return the updated Task row for the executor to run.
- *
- * Returns `data: null` when no TODO task matches. On optimistic lock conflict,
- * `updateTargetDetails` throws — callers may catch `isOptimisticLockError` to retry.
- */
-export const patchClaimTask = async ({ nodeId, availableTaskList, }) => {
-    if (availableTaskList.length === 0) {
-        console.log("[patchClaimTask] skipped: availableTaskList is empty", { nodeId });
-        return generateResponse.success(null);
-    }
-    // Step 1: Pick one matching TODO task (not locked; another node may claim the same row next).
-    const { data: possibleTask } = await getPossibleTarget({
-        filterList: [
-            {
-                field: "category",
-                operator: "eq",
-                value: CategoryTask.TASK,
-            },
-            {
-                field: "details->>status",
-                operator: "eq",
-                value: TaskStatus.TODO,
-            },
-            {
-                field: "value",
-                operator: "in",
-                value: availableTaskList,
-            },
-        ],
-    });
-    if (possibleTask == null) {
-        console.log("[patchClaimTask] no TODO task for node capabilities", {
-            nodeId,
-            availableTaskList,
-        });
-        return generateResponse.success(null);
-    }
-    const todoTask = possibleTask;
-    console.log("[patchClaimTask] attempting claim", {
-        nodeId,
-        taskId: todoTask.id,
-        taskValue: todoTask.value,
-    });
-    // Step 2: Claim with DB optimistic lock — UPDATE only if status is still TODO.
+});
+// ─── patchChangeNodeStatus ───────────────────────────────────────────────────
+export const patchChangeNodeStatus = validateWithSchema(patchChangeNodeStatusSchema, "patchChangeNodeStatusSchema")(async ({ nodeId, status, fromStatus, traceId }) => {
+    const logger = createApiLogger("patchChangeNodeStatus", { traceId, labels: { nodeId } });
     const data = await updateTargetDetails({
-        id: todoTask.id,
-        optimisticLockFilterList: [
-            {
-                field: "details->>status",
-                operator: "eq",
-                value: TaskStatus.TODO,
-            },
-        ],
+        id: nodeId,
+        optimisticLockFilterList: fromStatus != null ? lockOnNodeStatus(fromStatus) : [],
         updateFn: (details) => ({
             ...details,
-            status: TaskStatus.DOING,
-            nodeId,
+            status,
+            lastHeartBeat: Date.now(),
         }),
     });
-    console.log("[patchClaimTask] claim succeeded", {
-        nodeId,
-        taskId: data.id,
-        taskValue: data.value,
-        status: data.details.status,
+    logger.info("节点状态更新成功", {
+        topic: "node",
+        data: {
+            nodeId,
+            status,
+            fromStatus,
+        },
     });
-    // Return full updated row so executor can read repo/params without another fetch.
     return generateResponse.success(data);
-};
+});
 //# sourceMappingURL=node.api.js.map

package/dist/node/node.api.js.map

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

package/dist/node/node.interface.d.ts

@@ -1,6 +1,8 @@
 import { Target } from "../core.interface";
 export declare enum NodeStatus {
+    /** Registered, not yet in worker loop. */
     READY = "READY",
+    /** Worker main loop is running (accepts tasks until shutdown). */
     BUSY = "BUSY",
     /** Heartbeat lost or voluntarily offline; considered unavailable by the scheduler. */
     LOST = "LOST",
@@ -25,4 +27,9 @@ export interface NodeDetails {
     status: NodeStatus;
     lastHeartBeat: number;
 }
+/** 主循环单轮运行时上下文 — 由 start() 创建并向下传递 */
+export interface NodeLoopContext {
+    loopTraceId: string;
+    nodeId: string;
+}
 //# sourceMappingURL=node.interface.d.ts.map

package/dist/node/node.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.interface.d.ts","sourceRoot":"","sources":["../../src/node/node.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,UAAU;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,sFAAsF;IACtF,IAAI,SAAS;IACb,kGAAkG;IAClG,QAAQ,aAAa;IACrB,mEAAmE;IACnE,QAAQ,aAAa;CACxB;AAED,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"node.interface.d.ts","sourceRoot":"","sources":["../../src/node/node.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,UAAU;IAClB,0CAA0C;IAC1C,KAAK,UAAU;IACf,kEAAkE;IAClE,IAAI,SAAS;IACb,sFAAsF;IACtF,IAAI,SAAS;IACb,kGAAkG;IAClG,QAAQ,aAAa;IACrB,mEAAmE;IACnE,QAAQ,aAAa;CACxB;AAED,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB"}

package/dist/node/node.interface.js

@@ -1,6 +1,8 @@
 export var NodeStatus;
 (function (NodeStatus) {
+    /** Registered, not yet in worker loop. */
     NodeStatus["READY"] = "READY";
+    /** Worker main loop is running (accepts tasks until shutdown). */
     NodeStatus["BUSY"] = "BUSY";
     /** Heartbeat lost or voluntarily offline; considered unavailable by the scheduler. */
     NodeStatus["LOST"] = "LOST";

package/dist/node/node.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.interface.js","sourceRoot":"","sources":["../../src/node/node.interface.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,UASX;AATD,WAAY,UAAU;IAClB,6BAAe,CAAA;IACf,2BAAa,CAAA;IACb,sFAAsF;IACtF,2BAAa,CAAA;IACb,kGAAkG;IAClG,mCAAqB,CAAA;IACrB,mEAAmE;IACnE,mCAAqB,CAAA;AACzB,CAAC,EATW,UAAU,KAAV,UAAU,QASrB;AAED,MAAM,CAAN,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,6BAAa,CAAA;AACjB,CAAC,EAFW,YAAY,KAAZ,YAAY,QAEvB;AAeA,CAAC"}
+{"version":3,"file":"node.interface.js","sourceRoot":"","sources":["../../src/node/node.interface.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IAClB,0CAA0C;IAC1C,6BAAe,CAAA;IACf,kEAAkE;IAClE,2BAAa,CAAA;IACb,sFAAsF;IACtF,2BAAa,CAAA;IACb,kGAAkG;IAClG,mCAAqB,CAAA;IACrB,mEAAmE;IACnE,mCAAqB,CAAA;AACzB,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB;AAED,MAAM,CAAN,IAAY,YAEX;AAFD,WAAY,YAAY;IACpB,6BAAa,CAAA;AACjB,CAAC,EAFW,YAAY,KAAZ,YAAY,QAEvB;AAeA,CAAC"}

package/dist/node/node.utils.d.ts

@@ -0,0 +1,5 @@
+export declare const formatTimestamp: (timestamp: number) => string;
+export declare const formatRelativeTime: (timestamp: number) => string;
+export declare const getRandomInterval: () => number;
+export declare const formatHeartbeat: (timestamp: number) => string;
+//# sourceMappingURL=node.utils.d.ts.map

package/dist/node/node.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.utils.d.ts","sourceRoot":"","sources":["../../src/node/node.utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,cAAe,MAAM,KAAG,MAWnD,CAAC;AAEF,eAAO,MAAM,kBAAkB,cAAe,MAAM,KAAG,MAUtD,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO,MAIpC,CAAC;AAEF,eAAO,MAAM,eAAe,cAAe,MAAM,KAAG,MAInD,CAAC"}

package/dist/node/node.utils.js

@@ -0,0 +1,36 @@
+export const formatTimestamp = (timestamp) => {
+    return new Intl.DateTimeFormat("zh-CN", {
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hour12: false,
+        fractionalSecondDigits: 3,
+    }).format(timestamp);
+};
+export const formatRelativeTime = (timestamp) => {
+    const now = Date.now();
+    const diff = now - timestamp;
+    if (diff < 1000)
+        return "刚刚";
+    if (diff < 60000)
+        return `${Math.floor(diff / 1000)}秒前`;
+    if (diff < 3600000)
+        return `${Math.floor(diff / 60000)}分钟前`;
+    if (diff < 86400000)
+        return `${Math.floor(diff / 3600000)}小时前`;
+    return formatTimestamp(timestamp);
+};
+export const getRandomInterval = () => {
+    const min = 15 * 1000;
+    const max = 1 * 60 * 1000;
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+};
+export const formatHeartbeat = (timestamp) => {
+    const absolute = formatTimestamp(timestamp);
+    const relative = formatRelativeTime(timestamp);
+    return `${absolute} (${relative})`;
+};
+//# sourceMappingURL=node.utils.js.map

package/dist/node/node.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.utils.js","sourceRoot":"","sources":["../../src/node/node.utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAU,EAAE;IACzD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QACpC,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,KAAK;QACb,sBAAsB,EAAE,CAAC;KAC5B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAU,EAAE;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,GAAG,SAAS,CAAC;IAE7B,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxD,IAAI,IAAI,GAAG,OAAO;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;IAC5D,IAAI,IAAI,GAAG,QAAQ;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC;IAE/D,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAW,EAAE;IAC1C,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;IACtB,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAU,EAAE;IACzD,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC/C,OAAO,GAAG,QAAQ,KAAK,QAAQ,GAAG,CAAC;AACvC,CAAC,CAAC"}

package/dist/node/task-node.d.ts

@@ -0,0 +1,20 @@
+import { type LoggerWithScope } from "../shared/log";
+import { NodeLoopContext } from "./node.interface";
+import { BaseNodeRuntime } from "./node-runtime.base";
+/**
+ * Task worker node: commands → heartbeat → claim & execute tasks.
+ * Built on {@link BaseNodeRuntime}.
+ */
+declare class TaskNode extends BaseNodeRuntime {
+    private _availableTaskList;
+    private _includeRemote;
+    get availableTaskList(): readonly string[];
+    constructor();
+    protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
+    protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;
+    runAsWorker(ctx: NodeLoopContext): Promise<void>;
+    private abortTaskRun;
+    private finalizeTaskRun;
+}
+export { TaskNode };
+//# sourceMappingURL=task-node.d.ts.map

package/dist/node/task-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/node/task-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,eAAe,EACvB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;;cAMe,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAO5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjF,WAAW,CAAC,GAAG,EAAE,eAAe;YAwJxB,YAAY;YA2BZ,eAAe;CAoDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/node/task-node.js

@@ -0,0 +1,245 @@
+import { logManager, withModule, } from "../shared/log";
+import { scopeForNodeLoop } from "./node-log-scope";
+import { getErrorMessage, toError } from "../shared/utils/error.utils";
+import { TaskManager } from "../task/task-manager";
+import { patchChangeTaskStatus, patchClaimTask } from "../task/task.api";
+import { TaskStatusAction } from "../task/task.interface";
+import { BaseNodeRuntime } from "./node-runtime.base";
+/**
+ * Task worker node: commands → heartbeat → claim & execute tasks.
+ * Built on {@link BaseNodeRuntime}.
+ */
+class TaskNode extends BaseNodeRuntime {
+    _availableTaskList = [];
+    _includeRemote = true;
+    get availableTaskList() {
+        return [...this._availableTaskList];
+    }
+    constructor() {
+        super("taskNode");
+    }
+    async onBeforeRegisterNode(logger) {
+        logger.info("開始註冊任務", { topic: "node" });
+        const { availableTaskList, includeRemote } = await TaskManager.registerTasks({ logger });
+        this._availableTaskList = availableTaskList;
+        this._includeRemote = includeRemote;
+    }
+    async runLoopSteps(ctx, heartbeatOk) {
+        const loopScope = scopeForNodeLoop({
+            module: `${this.runtimeModule}-loop-iteration`,
+            traceId: ctx.loopTraceId,
+            nodeId: ctx.nodeId,
+        });
+        if (!heartbeatOk) {
+            const { logger } = logManager.withScope(loopScope);
+            logger.warn("心跳失敗，本輪跳過任務認領", { topic: "node" });
+            return;
+        }
+        await this.runAsWorker(ctx);
+    }
+    async runAsWorker(ctx) {
+        const { loopTraceId, nodeId } = ctx;
+        const loopScope = scopeForNodeLoop({ module: "runAsWorker", traceId: loopTraceId, nodeId });
+        const { logger } = logManager.withScope(loopScope);
+        const availableTaskList = this.availableTaskList;
+        if (availableTaskList.length === 0) {
+            logger.warn("未配置可認領任務類型，跳過本輪", { topic: "task" });
+            return;
+        }
+        logger.info("向 Supabase 認領任務", {
+            topic: "task",
+            data: { availableTaskList },
+        });
+        const { data: task, error: claimError } = await patchClaimTask({
+            nodeId,
+            availableTaskList: [...availableTaskList],
+            traceId: loopTraceId,
+        });
+        if (claimError) {
+            logger.error("認領任務 API 失敗", {
+                topic: "task",
+                data: {
+                    availableTaskList,
+                    error: claimError.message,
+                },
+            });
+            return;
+        }
+        if (task == null) {
+            logger.info("本輪無匹配的 TODO 任務", {
+                topic: "task",
+                data: { availableTaskList },
+            });
+            return;
+        }
+        logger.info("認領任務成功，準備執行", {
+            topic: "task",
+            data: {
+                taskId: task.id,
+                taskName: task.name,
+                taskTypeKey: task.value,
+                taskStatus: task.details.status,
+            },
+        });
+        const taskTraceId = task.details.traceId ?? loopTraceId;
+        const taskScope = scopeForNodeLoop({
+            module: "prepareTask",
+            traceId: taskTraceId,
+            nodeId,
+            traceParentId: loopTraceId,
+        });
+        const { logger: prepareLogger } = logManager.withScope(taskScope);
+        const prepareResult = await TaskManager.prepareTask({
+            logger: prepareLogger,
+            task,
+            includeRemote: this._includeRemote,
+        });
+        const { isSuccess: isPrepareSuccess, taskFn, code, message, reason, step } = prepareResult;
+        if (!isPrepareSuccess || taskFn == null) {
+            prepareLogger.critical("任務準備失敗，無法繼續執行，中止任務並 RESET 為 OPEN", {
+                topic: "task",
+                data: {
+                    taskId: task.id,
+                    taskTypeKey: task.value,
+                    code,
+                    message,
+                    reason,
+                    step,
+                },
+            });
+            await this.abortTaskRun({
+                logger: prepareLogger,
+                taskId: task.id,
+                nodeId,
+                traceId: taskTraceId,
+            });
+            return;
+        }
+        const { logger: executeLogger } = logManager.withScope(withModule(taskScope, "executeTask"));
+        const onExecuteAbort = async (error) => {
+            logger.critical("任務執行遇到未知錯誤，中止任務並 RESET 為 OPEN", {
+                topic: "task",
+                data: {
+                    taskId: task.id,
+                    taskName: task.name,
+                    taskTypeKey: task.value,
+                    error: getErrorMessage(error),
+                },
+            });
+            await this.abortTaskRun({
+                logger: executeLogger,
+                taskId: task.id,
+                nodeId,
+                traceId: taskTraceId,
+            });
+        };
+        executeLogger.info("開始執行業務邏輯", {
+            topic: "task",
+            data: { taskId: task.id, displayName: taskFn.displayName },
+        });
+        const startTime = Date.now();
+        let result = null;
+        try {
+            result = await taskFn();
+        }
+        catch (error) {
+            await onExecuteAbort(toError(error));
+            return;
+        }
+        if (result == null) {
+            await onExecuteAbort(new Error("任務執行結果為空"));
+            return;
+        }
+        executeLogger.info("任務執行完成", {
+            topic: "task",
+            data: { taskId: task.id, displayName: taskFn.displayName },
+        });
+        const { isSuccess: isTaskSuccess, cost, extra } = result ?? { isSuccess: false, cost: 0, extra: null };
+        if (isTaskSuccess) {
+            await this.finalizeTaskRun("success", {
+                logger: executeLogger,
+                taskId: task.id,
+                taskTypeKey: task.value,
+                nodeId,
+                cost,
+                extra,
+                traceId: taskTraceId,
+            });
+        }
+        else {
+            await this.finalizeTaskRun("failure", {
+                logger: executeLogger,
+                taskId: task.id,
+                taskTypeKey: task.value,
+                nodeId,
+                cost,
+                extra,
+                traceId: taskTraceId,
+            });
+        }
+        const duration = Date.now() - startTime;
+        executeLogger.info("業務邏輯執行完成", {
+            topic: "task",
+            data: { taskId: task.id, durationMs: duration },
+        });
+    }
+    async abortTaskRun(params) {
+        const { logger, taskId, nodeId, traceId, extra } = params;
+        const logData = { taskId, nodeId };
+        const extraValue = typeof extra === "string" ? extra : undefined;
+        const { error } = await patchChangeTaskStatus({
+            id: taskId,
+            action: TaskStatusAction.RESET,
+            nodeId,
+            extra: extraValue,
+            traceId,
+        });
+        if (error) {
+            logger.error(error.message, { topic: "task", data: logData });
+            return false;
+        }
+        logger.info("任務已中止並 RESET 為 OPEN", { topic: "task", data: logData });
+        return true;
+    }
+    async finalizeTaskRun(outcome, params) {
+        const { logger, taskId, nodeId, taskTypeKey, cost, extra, traceId } = params;
+        const outcomePrefix = outcome === "success" ? "任務成功" : "任務失敗";
+        const logData = {
+            taskTypeKey,
+            taskId,
+            nodeId,
+            ...(extra != null && extra !== "" ? { extra } : {}),
+        };
+        const extraValue = typeof extra === "string" ? extra : undefined;
+        const { error: changeTaskStatusError } = outcome === "success"
+            ? await patchChangeTaskStatus({
+                id: taskId,
+                action: TaskStatusAction.FINISH,
+                nodeId,
+                cost,
+                extra: extraValue,
+                traceId,
+            })
+            : await patchChangeTaskStatus({
+                id: taskId,
+                action: TaskStatusAction.RESET,
+                nodeId,
+                extra: extraValue,
+                traceId,
+            });
+        if (changeTaskStatusError) {
+            const upperMessage = `${outcomePrefix}但是更新 TaskStatus 失敗，產生孤兒 Task，請儘快排查問題`;
+            logger.critical(upperMessage, { topic: "task", data: logData });
+            throw new Error(upperMessage);
+        }
+        logger.info("更新 TaskStatus 成功", { topic: "task", data: logData });
+        if (outcome === "success") {
+            logger.success("任務執行結束，業務邏輯成功", { topic: "task", data: logData });
+        }
+        else {
+            logger.warn("任務執行結束，業務邏輯失敗", { topic: "task", data: logData });
+        }
+    }
+}
+export { TaskNode };
+//# sourceMappingURL=task-node.js.map

package/dist/node/task-node.js.map

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

package/dist/node/trigger-node.d.ts

@@ -0,0 +1,18 @@
+import { type LoggerWithScope } from "../shared/log";
+import { NodeLoopContext } from "./node.interface";
+import { BaseNodeRuntime } from "./node-runtime.base";
+/**
+ * Dedicated trigger scheduler node.
+ * Main loop: commands → heartbeat → evaluate due triggers → postTask.
+ *
+ * Phase 1: run a **single** TriggerNode process per deployment to avoid duplicate fires.
+ */
+declare class TriggerNode extends BaseNodeRuntime {
+    constructor();
+    protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
+    protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;
+    evaluateTriggers(ctx: NodeLoopContext): Promise<void>;
+    private fireTrigger;
+}
+export { TriggerNode };
+//# sourceMappingURL=trigger-node.d.ts.map

package/dist/node/trigger-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-node.d.ts","sourceRoot":"","sources":["../../src/node/trigger-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAOjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;GAKG;AACH,cAAM,WAAY,SAAQ,eAAe;;cAKrB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAI5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjF,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YA6C7C,WAAW;CA4E5B;AAmBD,OAAO,EAAE,WAAW,EAAE,CAAC"}