target-supabase-sdk 0.2.12 → 0.2.14

package/dist/shared/log/upload/interface.d.ts

@@ -0,0 +1,33 @@
+import type { TargetDraft } from "../../../core.interface";
+import type { List } from "../../../list/list.interface";
+import type { LogEntry } from "../core/log-manager";
+/**
+ * `ListDetails.loaderKey` stamped on every persisted log batch (write + read side).
+ * Business type: **LogBatch** (transport flush). Pairs with log-service **LogTrace**
+ * (`LogTrace.0`) after rekeying by `traceId`.
+ */
+export declare const LOG_PERSIST_LOADER_KEY = "LogBatch.0";
+/** Alias for {@link LOG_PERSIST_LOADER_KEY} — preferred when contrasting with LogTrace. */
+export declare const LOG_BATCH_LOADER_KEY = "LogBatch.0";
+/** Legacy transport metadata — fixed `"slow"` for spool uploads; required for downstream decode today. */
+export type LogPersistLane = "fast" | "medium" | "slow";
+export interface LogBatchMeta {
+    service: string;
+    process: string;
+    pid: number;
+    lane: LogPersistLane;
+    count: number;
+    from: number | null;
+    to: number | null;
+    flushedAt: number;
+    idempotencyKey: string;
+}
+export interface BuildLogListDraftInput {
+    service: string;
+    process: string;
+    lane: LogPersistLane;
+    idempotencyKey: string;
+    entries: LogEntry[];
+}
+export type LogListDraft = TargetDraft<List>;
+//# sourceMappingURL=interface.d.ts.map

package/dist/shared/log/upload/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../src/shared/log/upload/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,eAAyB,CAAC;AAE3D,0GAA0G;AAC1G,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC"}

package/dist/shared/log/upload/logger.d.ts

@@ -0,0 +1,22 @@
+/** User-facing / lifecycle logs — may be persisted like normal app logs. */
+export declare const LOG_PERSIST_TOPIC = "log-persist";
+/** Operational logs from the persist pipeline — never re-offered to avoid feedback loops. */
+export declare const LOG_PERSIST_INTERNAL_TOPIC = "log-persist-internal";
+type PipelineLogData = Record<string, unknown>;
+/** Supabase upload path (`postLogBatch`). */
+export declare const persistLogger: {
+    debug: (message: string, data?: PipelineLogData) => void;
+    info: (message: string, data?: PipelineLogData) => void;
+    warn: (message: string, data?: PipelineLogData) => void;
+    error: (message: string, data?: PipelineLogData) => void;
+};
+/** File spool writer + collector. */
+export declare const spoolLogger: {
+    debug: (message: string, data?: PipelineLogData) => void;
+    info: (message: string, data?: PipelineLogData) => void;
+    warn: (message: string, data?: PipelineLogData) => void;
+    error: (message: string, data?: PipelineLogData) => void;
+};
+export declare function isLogPersistInternalTopic(topic: string | undefined): boolean;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/log/upload/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/shared/log/upload/logger.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,6FAA6F;AAC7F,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAoB/C,6CAA6C;AAC7C,eAAO,MAAM,aAAa;qBARD,MAAM,SAAS,eAAe;oBAC/B,MAAM,SAAS,eAAe;oBAC9B,MAAM,SAAS,eAAe;qBAC7B,MAAM,SAAS,eAAe;CAKQ,CAAC;AAEhE,qCAAqC;AACrC,eAAO,MAAM,WAAW;qBAXC,MAAM,SAAS,eAAe;oBAC/B,MAAM,SAAS,eAAe;oBAC9B,MAAM,SAAS,eAAe;qBAC7B,MAAM,SAAS,eAAe;CAQK,CAAC;AAE7D,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE5E"}

package/package.json

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

package/src/browser.ts

@@ -171,6 +171,7 @@ export {
     registerServiceAtStartup,
     registrySlotRuntimePatchFromGuardResult,
     releaseSystemRegistrySlots,
+    releaseSystemRegistrySlotsByServiceId,
     resetSystemRegistryConfig,
     resetSystemRegistryConfigSchema,
     resolveActiveRegistryServiceId,

package/src/node/env/index.ts

@@ -7,10 +7,6 @@ export {
     CLI_PROD_FLAG,
     envProfileFromProcess,
     loadEnvFiles,
-    parseEnvFile,
-    parseEnvFileContent,
-    parseEnvLine,
-    pinEnvProfileFromArgv,
     resolveDefaultEnvFiles,
     SERVICE_ENV_PROFILE_ENV_KEY,
     SERVICE_ENV_PROFILE_PROD,

package/src/node/node-runtime.base.ts

@@ -12,9 +12,12 @@ import {
 } from "../shared/log";
 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 { formatHeartbeat, getRandomInterval } from "./node.utils";
 
+export { LOG_TOPIC_NODE };
+
 /** 主循环单轮运行时上下文 — 由 start() 创建并向下传递 */
 export interface NodeLoopContext {
     loopTraceId: string;
@@ -31,7 +34,6 @@ export interface BaseNodeRuntimeOptions {
     beforeProcessExit?: () => void | Promise<void>;
 }
 
-export const LOG_TOPIC_NODE = "node";
 const LOG_TOPIC_COMMAND = "command";
 const LOG_TOPIC_PROCESS = "process";
 
@@ -118,6 +120,25 @@ abstract class BaseNodeRuntime {
         return getRandomInterval();
     }
 
+    /**
+     * When true, the main loop skips commands and {@link runLoopSteps} (heartbeat only).
+     * Used by the L3 guard process while waiting for connectivity to recover.
+     */
+    protected isSilenced(): boolean {
+        return false;
+    }
+
+    /**
+     * Consecutive heartbeat failures reached {@link HEARTBEAT_FAILURE_THRESHOLD}.
+     * Default: shut down the node. Override to wait for recovery instead of exiting.
+     */
+    protected async onHealthCheckFailed(_ctx: NodeLoopContext): Promise<void> {
+        this.requestShutdown("heartbeat:consecutive-failures");
+    }
+
+    /** Heartbeat succeeded while {@link isSilenced} is true. Default: no-op. */
+    protected async onHeartbeatRecovered(_ctx: NodeLoopContext): Promise<void> {}
+
     private getLogNodeId(): string {
         return this.localNodeId ?? BaseNodeRuntime.NODE_ID_PENDING_ASSIGNMENT;
     }
@@ -284,7 +305,9 @@ abstract class BaseNodeRuntime {
                 data: { nodeId, loopCount: this.loopCount },
             });
             try {
-                await this.batchCommand(loopCtx);
+                if (!this.isSilenced()) {
+                    await this.batchCommand(loopCtx);
+                }
                 if (this.isShuttingDown()) {
                     iterLogger.debug("節點關閉中，跳過本輪剩餘步驟", { topic: LOG_TOPIC_NODE });
                     break;
@@ -294,7 +317,9 @@ abstract class BaseNodeRuntime {
                     iterLogger.debug("節點關閉中，跳過本輪剩餘步驟", { topic: LOG_TOPIC_NODE });
                     break;
                 }
-                await this.runLoopSteps(loopCtx, heartbeatOk);
+                if (!this.isSilenced()) {
+                    await this.runLoopSteps(loopCtx, heartbeatOk);
+                }
             } catch (error) {
                 iterLogger.critical(`主循環第 ${this.loopCount} 輪遇到未知錯誤`, {
                     topic: LOG_TOPIC_NODE,
@@ -410,11 +435,11 @@ abstract class BaseNodeRuntime {
                 threshold: BaseNodeRuntime.HEARTBEAT_FAILURE_THRESHOLD,
             };
             if (failureCount >= BaseNodeRuntime.HEARTBEAT_FAILURE_THRESHOLD) {
-                logger.critical("連續心跳失敗達上限，準備關閉節點", {
+                logger.critical("連續心跳失敗達上限", {
                     topic: LOG_TOPIC_NODE,
                     data: logData,
                 });
-                this.requestShutdown("heartbeat:consecutive-failures");
+                await this.onHealthCheckFailed(ctx);
             } else {
                 logger.warn("心跳更新失敗", { topic: LOG_TOPIC_NODE, data: logData });
             }
@@ -422,6 +447,9 @@ abstract class BaseNodeRuntime {
         }
 
         this.consecutiveHeartbeatFailures = 0;
+        if (this.isSilenced()) {
+            await this.onHeartbeatRecovered(ctx);
+        }
         // Success is the steady state every loop — do not INFO-spam; failures already warn/critical.
         logger.debug("心跳更新成功", {
             topic: LOG_TOPIC_NODE,

package/src/node/node.api.ts

@@ -2,10 +2,10 @@ import { z } from "zod";
 import { createTarget, type QueryFilter, updateTargetDetails, validateWithSchema } from "../core.api";
 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";
 
 const NODE_STATUS_FIELD = "details->>status" as const;
-const LOG_TOPIC_NODE = "node";
 
 const nodeIdSchema = z.string().trim().min(1);
 const traceIdSchema = z.string().trim().min(1).optional();

package/src/node/node.constant.ts

@@ -0,0 +1,2 @@
+/** Shared log topic for Node domain APIs and {@link BaseNodeRuntime}. */
+export const LOG_TOPIC_NODE = "node";

package/src/node/node.utils.ts

@@ -1,4 +1,4 @@
-export const formatTimestamp = (timestamp: number): string => {
+const formatTimestamp = (timestamp: number): string => {
     return new Intl.DateTimeFormat("zh-CN", {
         year: "numeric",
         month: "2-digit",
@@ -11,7 +11,7 @@ export const formatTimestamp = (timestamp: number): string => {
     }).format(timestamp);
 };
 
-export const formatRelativeTime = (timestamp: number): string => {
+const formatRelativeTime = (timestamp: number): string => {
     const now = Date.now();
     const diff = now - timestamp;
 

package/src/node/preload/run-service-preload.ts

@@ -1,14 +1,15 @@
 import { resolve } from "node:path";
-import { validateLogPersistPreloadEnv } from "../../shared/log/enable-log-persist";
-import { logManager } from "../../shared/log/log-manager";
-import { resolveLogMinLevel } from "../../shared/log/log-min-level";
-import { logPersistEnabledFromEnv } from "../../shared/log/log-persist.config";
+import { logManager } from "../../shared/log/core/log-manager";
+import { resolveLogMinLevel } from "../../shared/log/core/log-min-level";
+import { validateLogSpoolPreloadEnv } from "../../shared/log/spool/enable";
+import { mergeLogSpoolExtraProcessRolesEnv } from "../../shared/log/spool/process-roles";
+import { logSpoolEnabledFromEnv } from "../../shared/log/upload/env";
 import { loadEnvFiles, pinEnvProfileFromArgv } from "../env/load-env";
 import { resolveProjectRootByPackageName } from "../env/project-root";
 import type { ServicePreloadOptions } from "./service-preload.interface";
 
 function applyServiceEnvDefaults(projectRoot: string, options: ServicePreloadOptions): void {
-    if (!logPersistEnabledFromEnv()) {
+    if (!logSpoolEnabledFromEnv()) {
         return;
     }
 
@@ -22,6 +23,10 @@ function applyServiceEnvDefaults(projectRoot: string, options: ServicePreloadOpt
         const relative = options.runtimeDataDirRelative ?? "data/runtime";
         process.env.RUNTIME_DATA_DIR = resolve(projectRoot, relative);
     }
+
+    if (options.logSpoolExtraProcessRoles != null && options.logSpoolExtraProcessRoles.length > 0) {
+        mergeLogSpoolExtraProcessRolesEnv(process.env, options.logSpoolExtraProcessRoles);
+    }
 }
 
 function applyLogMinLevelFromEnv(options: ServicePreloadOptions): void {
@@ -56,7 +61,7 @@ export function runServicePreload(options: ServicePreloadOptions): void {
 
     applyLogMinLevelFromEnv(options);
 
-    validateLogPersistPreloadEnv();
+    validateLogSpoolPreloadEnv();
 
     // TODO: Phase 5 — optional unhandledRejection / uncaughtException formatters
     // (formerly watch-service preload-diagnostics.mjs)

package/src/node/preload/service-preload.interface.ts

@@ -1,4 +1,4 @@
-import type { LogLevel } from "../../shared/log/log-manager";
+import type { LogLevel } from "../../shared/log/core/log-manager";
 
 export interface ServicePreloadOptions {
     /** `import.meta.url` from the service `scripts/preload.mjs`. */
@@ -17,4 +17,6 @@ export interface ServicePreloadOptions {
     defaultLogMinLevel?: LogLevel;
     /** Apply `logManager.setOptions({ minLevel })` from env (default true). */
     applyLogMinLevel?: boolean;
+    /** Extra spool roles beyond main|guard|scheduler|worker (e.g. `chrome-sidecar`). Merged into `LOG_SPOOL_EXTRA_PROCESS_ROLES`. */
+    logSpoolExtraProcessRoles?: readonly string[];
 }

package/src/node/process/create-managed-child-processes.ts

@@ -1,4 +1,4 @@
-import { createLogger } from "../../shared/log/create-logger";
+import { createLogger } from "../../shared/log/core/create-logger";
 import type { ManagedChildProcessesOptions } from "./managed-child-processes";
 import { ManagedChildProcesses } from "./managed-child-processes";
 

package/src/node/process/managed-child-processes.ts

@@ -1,6 +1,7 @@
 import type { ChildProcess } from "node:child_process";
 import { resolve } from "node:path";
 import type { LoggerWithScope } from "../../shared/log";
+import { resolveLogSpoolSpawnEnvForLabel } from "../../shared/log/spool/enable";
 import { isChildProcessRunning, spawnTsxChild } from "./process-spawn";
 
 export interface ManagedChildProcessesOptions {
@@ -80,12 +81,18 @@ export class ManagedChildProcesses {
             return { child: existing, created: false };
         }
 
+        const logSpoolEnv = resolveLogSpoolSpawnEnvForLabel(label);
+        const childEnv =
+            spawnOptions?.env != null
+                ? { ...process.env, ...logSpoolEnv, ...spawnOptions.env }
+                : { ...process.env, ...logSpoolEnv };
+
         const child = spawnTsxChild({
             projectRoot: this.projectRoot,
             entryScript,
             preloadModules: this.preloadModules,
             useTsx: spawnOptions?.useTsx ?? this.defaultUseTsx,
-            env: spawnOptions?.env != null ? { ...process.env, ...spawnOptions.env } : process.env,
+            env: childEnv,
         });
 
         child.on("exit", (code: number | null, signal: NodeJS.Signals | null) => {

package/src/node/readiness/index.ts

@@ -12,6 +12,8 @@ export {
     createSupabaseReachableCheck,
 } from "./readiness-checks";
 export { runReadinessChecks } from "./run-readiness-checks";
+export type { RunReadinessGateInput } from "./run-readiness-gate";
+export { runReadinessGate } from "./run-readiness-gate";
 export type {
     ServiceReadyGate,
     ServiceReadySnapshot,

package/src/node/{service-guard → readiness}/run-readiness-gate.ts

@@ -1,6 +1,6 @@
 import type { LoggerWithScope } from "../../shared/log";
-import type { ReadinessCheck, ReadinessReport } from "../readiness/readiness.types";
-import { runReadinessChecks } from "../readiness/run-readiness-checks";
+import type { ReadinessCheck, ReadinessReport } from "./readiness.types";
+import { runReadinessChecks } from "./run-readiness-checks";
 
 export interface RunReadinessGateInput {
     checks: ReadinessCheck[];

package/src/node/readiness/service-ready-gate.ts

@@ -1,8 +1,5 @@
 import type { LoggerWithScope } from "../../shared/log";
-
-function sleep(ms: number): Promise<void> {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
+import { pollUntil } from "./poll-until";
 
 export interface ServiceReadySnapshot {
     failed: boolean;
@@ -36,30 +33,37 @@ export async function waitForServiceReady(
 ): Promise<ServiceReadySnapshot> {
     const pollMs = options.pollMs ?? 500;
     const defaultFailureMessage = options.failureMessage ?? "Readiness checks failed";
-    const deadline = Date.now() + options.timeoutMs;
     let last: ServiceReadySnapshot = { failed: false, ready: false };
 
-    while (Date.now() < deadline) {
-        last = await gate.read();
-
+    try {
+        await pollUntil({
+            timeoutMs: options.timeoutMs,
+            intervalMs: pollMs,
+            until: async () => {
+                last = await gate.read();
+                if (last.failed) {
+                    throw new Error(last.failureMessage ?? defaultFailureMessage);
+                }
+                return last.ready;
+            },
+        });
+    } catch (error) {
         if (last.failed) {
-            throw new Error(last.failureMessage ?? defaultFailureMessage);
+            throw error instanceof Error ? error : new Error(defaultFailureMessage);
         }
-
-        if (last.ready) {
-            options.logger?.info("service ready", {
-                topic: "readiness",
-                data: last.readyDetail ?? {},
-            });
-            return last;
+        const isPollTimeout = error instanceof Error && error.message.startsWith("pollUntil timeout after");
+        if (!isPollTimeout) {
+            throw error;
         }
-
-        await sleep(pollMs);
+        const message =
+            options.formatTimeoutError?.(last, options.timeoutMs) ??
+            `Service ready timeout after ${options.timeoutMs}ms (failed=${last.failed}, ready=${last.ready})`;
+        throw new Error(message);
     }
 
-    const message =
-        options.formatTimeoutError?.(last, options.timeoutMs) ??
-        `Service ready timeout after ${options.timeoutMs}ms (failed=${last.failed}, ready=${last.ready})`;
-
-    throw new Error(message);
+    options.logger?.info("service ready", {
+        topic: "readiness",
+        data: last.readyDetail ?? {},
+    });
+    return last;
 }

package/src/node/runtime-state/create-service-runtime-state-store.ts

@@ -58,11 +58,22 @@ function createDefaultServiceRuntimeState<TExtraSlices extends Record<string, ob
         lastDecision: null,
         lastSpawnAt: null,
         spawnCount: 0,
+        mode: "healthy",
+        silentEnteredAt: null,
+        silentLastHeartbeatAt: null,
+        silentBackoffMs: 0,
+        silentConsecutiveFailures: 0,
+        silentRecoveryAttempt: 0,
+        silentEvents: [],
     };
     const scheduler: SchedulerRuntimeSlice = {
         lastTickAt: null,
         lastPostedCount: 0,
         lastFired: {},
+        pid: null,
+        spawnedAt: null,
+        ready: false,
+        readyAt: null,
     };
     const worker: WorkerRuntimeSlice = {
         pid: null,

package/src/node/runtime-state/service-runtime-state.types.ts

@@ -15,12 +15,24 @@ export interface GuardRuntimeSlice {
     lastDecision: string | null;
     lastSpawnAt: string | null;
     spawnCount: number;
+    /** `healthy` when omitted (legacy shards). Silent: heartbeat-only wait. Recovering: respawn business nodes. */
+    mode: "healthy" | "silent" | "recovering";
+    silentEnteredAt: string | null;
+    silentLastHeartbeatAt: string | null;
+    silentBackoffMs: number;
+    silentConsecutiveFailures: number;
+    silentRecoveryAttempt: number;
+    silentEvents: { at: string; type: string; detail?: string }[];
 }
 
 export interface SchedulerRuntimeSlice {
     lastTickAt: string | null;
     lastPostedCount: number;
     lastFired: Record<string, string>;
+    pid: number | null;
+    spawnedAt: string | null;
+    ready: boolean;
+    readyAt: string | null;
 }
 
 export interface WorkerRuntimeSlice {

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

@@ -1,6 +1,9 @@
 export { registerServiceGuardRunner } from "./register-service-guard-runner";
-export type { RunReadinessGateInput } from "./run-readiness-gate";
-export { runReadinessGate } from "./run-readiness-gate";
+export type {
+    ApplyRegistrySlotGuardInput,
+    ApplyRegistrySlotGuardResult,
+} from "./registry-slot-guard-step";
+export { applyRegistrySlotGuardStep } from "./registry-slot-guard-step";
 export { runServiceGuardTick } from "./run-service-guard-tick";
 export type {
     RegisterServiceGuardRunnerOptions,
@@ -8,10 +11,6 @@ export type {
     ServiceGuardTickInput,
     ServiceGuardTickResult,
 } from "./service-guard.interface";
-export { SERVICE_GUARD_RUNNER_KEY } from "./service-guard.interface";
+export { guardRetryAfterSec, isGuardAvailable, SERVICE_GUARD_RUNNER_KEY } from "./service-guard.interface";
 export { ServiceGuardNode } from "./service-guard-node";
-export {
-    getWorkerSpawnCooldownLastAt,
-    markWorkerSpawned,
-    resetWorkerSpawnCooldownForTests,
-} from "./worker-spawn-cooldown";
+export { markWorkerSpawned } from "./worker-spawn-cooldown";

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

@@ -60,5 +60,3 @@ export function registerServiceGuardRunner(options: RegisterServiceGuardRunnerOp
         fn: (ctx) => runServiceGuardRunner(ctx, options),
     });
 }
-
-export { SERVICE_GUARD_RUNNER_KEY };

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

@@ -1,5 +1,8 @@
-import { CategoryNode, evaluateBusyNodeLiveness, type Node, patchServiceRuntime, scanTargetList } from "../../browser";
-import { applyRegistrySlotGuardStep } from "../service-host/registry-slot-guard-step";
+import { scanTargetList } from "../../core.api";
+import { patchServiceRuntime } from "../../service/registry.service";
+import { CategoryNode, type Node } from "../node.interface";
+import { evaluateBusyNodeLiveness } 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";