target-supabase-sdk 0.2.25 → 0.3.0

package/dist/preload.js

@@ -1,6 +1,6 @@
 import { resolve } from 'node:path';
-import { w as logManager, H as resolveLogMinLevel } from './chunks/list.api-B-aM4vzv.js';
-import { r as resolveProjectRootByPackageName, p as pinEnvProfileFromArgv, l as loadEnvFiles, v as validateLogSpoolPreloadEnv, a as logSpoolEnabledFromEnv, m as mergeLogSpoolExtraProcessRolesEnv } from './chunks/enable-DkiKPHDl.js';
+import { w as logManager, H as resolveLogMinLevel } from './chunks/config-BNxsVKR4.js';
+import { r as resolveProjectRootByPackageName, p as pinEnvProfileFromArgv, l as loadEnvFiles, v as validateLogSpoolPreloadEnv, a as logSpoolEnabledFromEnv, m as mergeLogSpoolExtraProcessRolesEnv } from './chunks/enable-CF77OsXr.js';
 import 'node:crypto';
 import 'zod';
 import 'lodash-es';

package/dist/service/service.interface.d.ts

@@ -25,7 +25,7 @@ export interface ServiceDetails {
     /** Present on runtime instances; omitted on catalog-only rows until guard starts. */
     runtime?: ServiceRuntime;
 }
-/** Per-node snapshot under a running Service — maintained by the service guard. */
+/** Per-node snapshot for nodes owned by this Service instance (`Node.name === serviceId`). */
 export interface ServiceNodeSnapshot {
     nodeId: string;
     status: NodeStatus;
@@ -33,7 +33,7 @@ export interface ServiceNodeSnapshot {
 }
 /**
  * Runtime observability for a registered Service instance.
- * Heartbeat and node rollups are written by the service guard, not the system registry Config.
+ * Heartbeat and node rollups are written by the service guard (scoped to this instance), not the system registry Config.
  */
 export interface ServiceRuntime {
     lastHeartBeat: number;

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

@@ -1 +1 @@
-{"version":3,"file":"service.interface.d.ts","sourceRoot":"","sources":["../../src/service/service.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACnC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;CAC3B;AAED,oBAAY,eAAe;IACvB,OAAO,YAAY;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,qFAAqF;IACrF,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,GAAI,SAAQ,MAAM;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED,oBAAY,WAAW;IACnB,GAAG,QAAQ;CACd;AAED,oBAAY,SAAS;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACL,KAAK,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;IACF,QAAQ,EAAE;QACN,KAAK,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;CAG/B"}
+{"version":3,"file":"service.interface.d.ts","sourceRoot":"","sources":["../../src/service/service.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACnC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;CAC3B;AAED,oBAAY,eAAe;IACvB,OAAO,YAAY;CACtB;AAED,MAAM,WAAW,cAAc;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,qFAAqF;IACrF,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,8FAA8F;AAC9F,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,GAAI,SAAQ,MAAM;IAC/B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACvB;AAED,oBAAY,WAAW;IACnB,GAAG,QAAQ;CACd;AAED,oBAAY,SAAS;IACjB,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,MAAM,WAAW;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACL,KAAK,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;IACF,QAAQ,EAAE;QACN,KAAK,EAAE,eAAe,EAAE,CAAC;KAC5B,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;CAG/B"}

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

@@ -1,4 +1,5 @@
-import { BaseNodeRuntime, type NodeLoopContext } from "../node/node-runtime.base";
+import { BaseNodeRuntime, type NodeLoopContext } from "../node/base-node-runtime";
+import { NodeKind } from "../node/node.interface";
 import { type LoggerWithScope } from "../shared/log";
 import { type PatchClaimTaskPayload } from "./task.api";
 /**
@@ -12,6 +13,7 @@ declare class TaskNode extends BaseNodeRuntime {
     /** Optional claim filters passed to {@link patchClaimTask} (e.g. name prefix per task type). */
     protected getPatchClaimTaskOptions(): Pick<PatchClaimTaskPayload, "namePrefixList">;
     constructor();
+    protected getNodeKind(): NodeKind;
     protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
     protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;
     private runAsWorker;

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

@@ -1 +1 @@
-{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAE5F,OAAO,EAAE,KAAK,qBAAqB,EAAyC,MAAM,YAAY,CAAC;AAK/F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;IAED,gGAAgG;IAChG,SAAS,CAAC,wBAAwB,IAAI,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;;cAQnE,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA8KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAE5F,OAAO,EAAE,KAAK,qBAAqB,EAAyC,MAAM,YAAY,CAAC;AAK/F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;IAED,gGAAgG;IAChG,SAAS,CAAC,wBAAwB,IAAI,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;;IAQnF,SAAS,CAAC,WAAW,IAAI,QAAQ;cAIjB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA8KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

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

@@ -1,4 +1,4 @@
-import type { NodeLoopContext } from "../node/node-runtime.base";
+import type { NodeLoopContext } from "../node/base-node-runtime";
 import type { RegisterTriggerRunnerOptions } from "./trigger.interface";
 export type { RegisterTriggerRunnerOptions, TriggerRunnerContext, TriggerRunnerFn } from "./trigger.interface";
 /** In-process registry and tick loop for {@link TriggerNode}. */

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

@@ -1,4 +1,5 @@
-import { BaseNodeRuntime, type NodeLoopContext } from "../node/node-runtime.base";
+import { BaseNodeRuntime, type NodeLoopContext } from "../node/base-node-runtime";
+import { NodeKind } from "../node/node.interface";
 import { type LoggerWithScope, LogLevel } from "../shared/log";
 import type { TriggerNodeOptions } from "./trigger.interface";
 /**
@@ -14,6 +15,7 @@ declare class TriggerNode extends BaseNodeRuntime {
     private readonly requireRunners;
     private readonly loopIntervalMs;
     constructor(options?: TriggerNodeOptions);
+    protected getNodeKind(): NodeKind;
     protected getLoopIntervalMs(): number;
     protected loopLoggerMinLevel(): LogLevel;
     protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"trigger-node.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;;GAQG;AACH,cAAM,WAAY,SAAQ,eAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,CAAC,EAAE,kBAAkB;IAUxC,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,SAAS,CAAC,kBAAkB,IAAI,QAAQ;cAIxB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cA+B5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAc1F;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"trigger-node.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAA6B,KAAK,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D;;;;;;;;GAQG;AACH,cAAM,WAAY,SAAQ,eAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,CAAC,EAAE,kBAAkB;IAUxC,SAAS,CAAC,WAAW,IAAI,QAAQ;IAIjC,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,SAAS,CAAC,kBAAkB,IAAI,QAAQ;cAIxB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cA+B5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAc1F;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/trigger/trigger.api.d.ts

@@ -11,13 +11,13 @@ export declare const postTriggerSchema: z.ZodObject<{
         hour: z.ZodNumber;
         minute: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        kind: "daily";
         hour: number;
         minute: number;
-        kind: "daily";
     }, {
+        kind: "daily";
         hour: number;
         minute: number;
-        kind: "daily";
     }>;
     action: z.ZodObject<{
         kind: z.ZodLiteral<"post_task">;
@@ -26,14 +26,14 @@ export declare const postTriggerSchema: z.ZodObject<{
         taskName: z.ZodOptional<z.ZodString>;
         taskStatus: z.ZodOptional<z.ZodEnum<[TaskStatus.OPEN, TaskStatus.TODO]>>;
     }, "strip", z.ZodTypeAny, {
-        taskTypeKey: string;
         kind: "post_task";
+        taskTypeKey: string;
         taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
         taskParams?: unknown;
         taskName?: string | undefined;
     }, {
-        taskTypeKey: string;
         kind: "post_task";
+        taskTypeKey: string;
         taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
         taskParams?: unknown;
         taskName?: string | undefined;
@@ -46,32 +46,32 @@ export declare const postTriggerSchema: z.ZodObject<{
     name: string;
     tagList: string[];
     action: {
-        taskTypeKey: string;
         kind: "post_task";
+        taskTypeKey: string;
         taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
         taskParams?: unknown;
         taskName?: string | undefined;
     };
     schedule: {
+        kind: "daily";
         hour: number;
         minute: number;
-        kind: "daily";
     };
     traceId?: string | undefined;
 }, {
     value: string;
     name: string;
     action: {
-        taskTypeKey: string;
         kind: "post_task";
+        taskTypeKey: string;
         taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
         taskParams?: unknown;
         taskName?: string | undefined;
     };
     schedule: {
+        kind: "daily";
         hour: number;
         minute: number;
-        kind: "daily";
     };
     status?: TriggerStatus | undefined;
     tagList?: string[] | undefined;
@@ -119,16 +119,16 @@ export declare const postTrigger: (payload: {
     name: string;
     tagList: string[];
     action: {
-        taskTypeKey: string;
         kind: "post_task";
+        taskTypeKey: string;
         taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
         taskParams?: unknown;
         taskName?: string | undefined;
     };
     schedule: {
+        kind: "daily";
         hour: number;
         minute: number;
-        kind: "daily";
     };
     traceId?: string | undefined;
 }) => SupabaseResponse<Trigger> | Promise<SupabaseResponse<Trigger>>;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "target-supabase-sdk",
-    "version": "0.2.25",
+    "version": "0.3.0",
     "description": "Supabase client initializer and data access APIs",
     "license": "MIT",
     "author": "KyLoc20",

package/src/browser.ts

@@ -43,7 +43,8 @@ export type {
     TaskNodeLivenessFreshest,
     TaskNodeLivenessReport,
 } from "./node/node-liveness";
-export { evaluateBusyNodeLiveness } from "./node/node-liveness";
+export { evaluateBusyNodeLiveness, nodesForTaskLiveness } from "./node/node-liveness";
+export { requireNodeServiceIdFromEnv } from "./node/node-service-id";
 export type { ChunkResolveProvider } from "./parcel/chunk-fetch-registry";
 export {
     installChunkFetchRegistry,

package/src/node/{node-runtime.base.ts → base-node-runtime.ts}

@@ -13,8 +13,9 @@ import {
 import { getErrorMessage } from "../shared/utils/error.utils";
 import { patchChangeNodeStatus, patchNodeHeartBeat, patchStopNode, postRegisterNode } from "./node.api";
 import { LOG_TOPIC_NODE } from "./node.constant";
-import { NodeStatus } from "./node.interface";
+import { type NodeKind, NodeStatus } from "./node.interface";
 import { formatHeartbeat, getRandomInterval } from "./node.utils";
+import { requireNodeServiceIdFromEnv } from "./node-service-id";
 
 export { LOG_TOPIC_NODE };
 
@@ -43,6 +44,9 @@ const LOG_TOPIC_PROCESS = "process";
  */
 abstract class BaseNodeRuntime {
     protected static readonly HEARTBEAT_FAILURE_THRESHOLD = 3;
+
+    /** Role written to {@link Node.value} at registration. */
+    protected abstract getNodeKind(): NodeKind;
     /** Log `nodeId` label while startup has not yet received an assigned id from Supabase. */
     private static readonly NODE_ID_PENDING_ASSIGNMENT = "pending-node-id";
 
@@ -241,7 +245,12 @@ abstract class BaseNodeRuntime {
 
         logger.debug("開始向 Supabase 註冊節點", { topic: LOG_TOPIC_NODE });
         try {
-            const { data, error } = await postRegisterNode({ traceId: this.startupTraceId });
+            const serviceId = requireNodeServiceIdFromEnv();
+            const { data, error } = await postRegisterNode({
+                serviceId,
+                kind: this.getNodeKind(),
+                traceId: this.startupTraceId,
+            });
             if (data == null || error) {
                 throw error ?? new Error("postRegisterNode 失敗");
             }

package/src/node/node-liveness.ts

@@ -1,4 +1,4 @@
-import { type Node, NodeStatus } from "./node.interface";
+import { type Node, NodeKind, NodeStatus } from "./node.interface";
 
 export interface TaskNodeLivenessFreshest {
     nodeId: string;
@@ -33,6 +33,11 @@ function isBusyWithHeartbeat(node: Node): boolean {
     return node.details.status === NodeStatus.BUSY && typeof node.details.lastHeartBeat === "number";
 }
 
+/** Subset used for worker liveness (Guard / observability) — {@link NodeKind.TASK} only. */
+export function nodesForTaskLiveness(nodes: readonly Node[]): Node[] {
+    return nodes.filter((node) => node.value === NodeKind.TASK);
+}
+
 /** Evaluate TaskNode liveness from a scanned node list (no I/O). */
 export function evaluateBusyNodeLiveness(
     nodes: Node[],

package/src/node/node-service-id.ts

@@ -0,0 +1,12 @@
+import { LOG_SPOOL_SERVICE_ID_ENV } from "../shared/log/spool/config";
+
+/** Service instance id required for {@link postRegisterNode} (same env as log spool after registry claim). */
+export function requireNodeServiceIdFromEnv(env: NodeJS.ProcessEnv = process.env): string {
+    const serviceId = env[LOG_SPOOL_SERVICE_ID_ENV]?.trim();
+    if (serviceId == null || serviceId === "") {
+        throw new Error(
+            `[Node] ${LOG_SPOOL_SERVICE_ID_ENV} must be set before registering a node (claim the registry slot on the service host first)`,
+        );
+    }
+    return serviceId;
+}

package/src/node/node.api.ts

@@ -3,7 +3,7 @@ import { createTarget, type QueryFilter, updateTargetDetails, validateWithSchema
 import { generateResponse } from "../core.interface";
 import { createLogger } from "../shared/log";
 import { LOG_TOPIC_NODE } from "./node.constant";
-import { CategoryNode, type Node, type NodeDetails, NodeStatus } from "./node.interface";
+import { CategoryNode, type Node, type NodeDetails, NodeKind, NodeStatus } from "./node.interface";
 
 const NODE_STATUS_FIELD = "details->>status" as const;
 
@@ -13,6 +13,8 @@ const traceIdSchema = z.string().trim().min(1).optional();
 // ─── Zod schemas ─────────────────────────────────────────────────────────────
 
 export const postRegisterNodeSchema = z.object({
+    serviceId: nodeIdSchema,
+    kind: z.nativeEnum(NodeKind),
     traceId: traceIdSchema,
 });
 
@@ -53,9 +55,9 @@ function lockOnNodeStatus(status: NodeStatus): QueryFilter[] {
 export const postRegisterNode = validateWithSchema(
     postRegisterNodeSchema,
     "postRegisterNodeSchema",
-)(async (payload) => {
+)(async ({ serviceId, kind, ...payload }) => {
     return createTarget<Node, PostRegisterNodePayload>({
-        payload,
+        payload: { serviceId, kind, ...payload },
         createFn: () => {
             const details: NodeDetails = {
                 manifestVersion: 0,
@@ -63,9 +65,9 @@ export const postRegisterNode = validateWithSchema(
                 lastHeartBeat: Date.now(),
             };
             return {
-                name: "",
+                name: serviceId,
                 category: CategoryNode.NODE,
-                value: "",
+                value: kind,
                 tagList: [],
                 details,
             };

package/src/node/node.interface.ts

@@ -17,10 +17,18 @@ export enum CategoryNode {
     NODE = "node",
 }
 
+/** Node role — stored in {@link Node.value}. */
+export enum NodeKind {
+    TASK = "node.task",
+    TRIGGER = "node.trigger",
+    GUARD = "node.guard",
+    OTHER = "node.other",
+}
+
 export interface Node extends Target {
-    /** Empty */
+    /** Owning Service instance id (`postService` row id); empty when not bound to a service. */
     name: string;
-    /** Empty */
+    /** Node role — {@link NodeKind}. */
     value: string;
     details: NodeDetails;
     category: CategoryNode;

package/src/node/service-guard/run-service-guard-tick.ts

@@ -1,7 +1,7 @@
 import { scanTargetList } from "../../core.api";
 import { patchServiceRuntime } from "../../service/registry/registry.service";
 import { CategoryNode, type Node } from "../node.interface";
-import { evaluateBusyNodeLiveness } from "../node-liveness";
+import { evaluateBusyNodeLiveness, nodesForTaskLiveness } from "../node-liveness";
 import { applyRegistrySlotGuardStep } from "./registry-slot-guard-step";
 import type { ServiceGuardTickInput, ServiceGuardTickResult } from "./service-guard.interface";
 import { getWorkerSpawnCooldownLastAt, markWorkerSpawned } from "./worker-spawn-cooldown";
@@ -48,12 +48,18 @@ export async function runServiceGuardTick(input: ServiceGuardTickInput): Promise
         decision = "slot_ok";
     }
 
-    const { data: nodes = [] } = await scanTargetList<Node>({
-        category: CategoryNode.NODE,
-        maxRows: maxNodes,
-    });
+    const nodes =
+        serviceId == null
+            ? []
+            : ((
+                  await scanTargetList<Node>({
+                      category: CategoryNode.NODE,
+                      filterList: [{ field: "name", operator: "eq", value: serviceId }],
+                      maxRows: maxNodes,
+                  })
+              ).data ?? []);
 
-    const liveness = evaluateBusyNodeLiveness(nodes, {
+    const liveness = evaluateBusyNodeLiveness(nodesForTaskLiveness(nodes), {
         staleMs: taskNodeStaleMs,
         now: nowMs,
         excludeNodeId: nodeId,

package/src/node/service-guard/service-guard-node.ts

@@ -2,7 +2,8 @@ import { createLogger, type LoggerWithScope } from "../../shared/log";
 import { registerCollectLogRunner } from "../../shared/log/spool/register-collect-log-runner";
 import { getErrorMessage } from "../../shared/utils/error.utils";
 import { TriggerNode } from "../../trigger/trigger-node";
-import type { NodeLoopContext } from "../node-runtime.base";
+import type { NodeLoopContext } from "../base-node-runtime";
+import { NodeKind } from "../node.interface";
 import { pollUntil } from "../readiness/poll-until";
 import { runReadinessGate } from "../readiness/run-readiness-gate";
 import type { GuardRuntimeSlice } from "../runtime-state/service-runtime-state.types";
@@ -40,6 +41,10 @@ class ServiceGuardNode extends TriggerNode {
         this.businessReadyTimeoutMs = options.businessReadyTimeoutMs ?? DEFAULT_BUSINESS_READY_TIMEOUT_MS;
     }
 
+    protected getNodeKind(): NodeKind {
+        return NodeKind.GUARD;
+    }
+
     /** Register the guard runner and return a ready-to-start node. */
     static create(options: ServiceGuardNodeOptions): ServiceGuardNode {
         registerServiceGuardRunner({

package/src/node/service-host/service-host.ts

@@ -127,9 +127,10 @@ export function createServiceHost(options: ServiceHostOptions): ServiceHost {
             await options.onRegistryClaimed(hostCtx);
         }
 
+        process.env[LOG_SPOOL_SERVICE_ID_ENV] = session.service.id;
+
         const enableSpool = options.enableLogSpoolAfterClaim ?? true;
         if (enableSpool && logSpoolEnabledFromEnv()) {
-            process.env[LOG_SPOOL_SERVICE_ID_ENV] = session.service.id;
             await ensureLogSpoolFromEnv({
                 serviceId: session.service.id,
                 serviceValue: options.serviceValue,

package/src/node/service-host/single-process-service.ts

@@ -1,6 +1,7 @@
 import type { ServiceRegistrySession } from "../../service/registry/registry-lifecycle";
 import type { Service } from "../../service/service.interface";
 import { createLogger, type LoggerWithScope } from "../../shared/log";
+import { LOG_SPOOL_SERVICE_ID_ENV } from "../../shared/log/spool/config";
 import { claimRegistrySlotOrExit } from "./claim-registry-slot";
 
 export interface SingleProcessServiceContext {
@@ -37,6 +38,8 @@ export async function runSingleProcessService(options: SingleProcessServiceOptio
         logTopic,
     });
 
+    process.env[LOG_SPOOL_SERVICE_ID_ENV] = session.service.id;
+
     try {
         await options.run({ service: session.service, session });
     } catch (error: unknown) {

package/src/node.ts

@@ -7,6 +7,8 @@
 export * from "./browser";
 export * from "./command/command.api";
 export * from "./command/command.interface";
+export type { BaseNodeRuntimeOptions, NodeLoopContext } from "./node/base-node-runtime";
+export { BaseNodeRuntime } from "./node/base-node-runtime";
 export type {
     EnvIntOptions,
     EnvNumberOptions,
@@ -48,8 +50,6 @@ export {
     nodeBufferToArrayBuffer,
     readAndVerifySourceFile,
 } from "./node/fs/read-source-file";
-export type { BaseNodeRuntimeOptions, NodeLoopContext } from "./node/node-runtime.base";
-export { BaseNodeRuntime } from "./node/node-runtime.base";
 export type {
     BuildNodeImportArgsInput,
     CreateManagedChildProcessesOptions,

package/src/service/service.interface.ts

@@ -29,7 +29,7 @@ export interface ServiceDetails {
     runtime?: ServiceRuntime;
 }
 
-/** Per-node snapshot under a running Service — maintained by the service guard. */
+/** Per-node snapshot for nodes owned by this Service instance (`Node.name === serviceId`). */
 export interface ServiceNodeSnapshot {
     nodeId: string;
     status: NodeStatus;
@@ -38,7 +38,7 @@ export interface ServiceNodeSnapshot {
 
 /**
  * Runtime observability for a registered Service instance.
- * Heartbeat and node rollups are written by the service guard, not the system registry Config.
+ * Heartbeat and node rollups are written by the service guard (scoped to this instance), not the system registry Config.
  */
 export interface ServiceRuntime {
     lastHeartBeat: number;

package/src/task/task-node.ts

@@ -1,5 +1,6 @@
 import { isOptimisticLockResponse } from "../core.api";
-import { BaseNodeRuntime, LOG_TOPIC_NODE, type NodeLoopContext } from "../node/node-runtime.base";
+import { BaseNodeRuntime, LOG_TOPIC_NODE, type NodeLoopContext } from "../node/base-node-runtime";
+import { NodeKind } from "../node/node.interface";
 import { createLogger, createScope, type LoggerWithScope, withModule } from "../shared/log";
 import { getErrorMessage, toError } from "../shared/utils/error.utils";
 import { type PatchClaimTaskPayload, patchChangeTaskStatus, patchClaimTask } from "./task.api";
@@ -28,6 +29,10 @@ class TaskNode extends BaseNodeRuntime {
         super("taskNode");
     }
 
+    protected getNodeKind(): NodeKind {
+        return NodeKind.TASK;
+    }
+
     protected async onBeforeRegisterNode(logger: LoggerWithScope): Promise<void> {
         const { availableTaskList, includeRemote } = await TaskManager.registerTasks({ logger });
         this._availableTaskList = availableTaskList;

package/src/trigger/trigger-manager.ts

@@ -1,4 +1,4 @@
-import type { NodeLoopContext } from "../node/node-runtime.base";
+import type { NodeLoopContext } from "../node/base-node-runtime";
 import { createLogger, createScope, withModule } from "../shared/log";
 import { getErrorMessage } from "../shared/utils/error.utils";
 import {

package/src/trigger/trigger-node.ts

@@ -1,4 +1,5 @@
-import { BaseNodeRuntime, LOG_TOPIC_NODE, type NodeLoopContext } from "../node/node-runtime.base";
+import { BaseNodeRuntime, LOG_TOPIC_NODE, type NodeLoopContext } from "../node/base-node-runtime";
+import { NodeKind } from "../node/node.interface";
 import { createLogger, createScope, type LoggerWithScope, LogLevel } from "../shared/log";
 import { LOG_TOPIC_TRIGGER, TRIGGER_LOOP_INTERVAL_MS } from "./trigger.constant";
 import type { TriggerNodeOptions } from "./trigger.interface";
@@ -27,6 +28,10 @@ class TriggerNode extends BaseNodeRuntime {
         this.loopIntervalMs = loopIntervalMs;
     }
 
+    protected getNodeKind(): NodeKind {
+        return NodeKind.TRIGGER;
+    }
+
     protected getLoopIntervalMs(): number {
         return this.loopIntervalMs;
     }