target-supabase-sdk 0.2.11 → 0.2.13

package/dist/shared/log/{log-persist-batch-id.d.ts → upload/batch-id.d.ts}

@@ -1,5 +1,5 @@
-import type { LogEntry } from "./log-manager";
-import type { LogPersistLane } from "./log-persist.interface";
+import type { LogEntry } from "../core/log-manager";
+import type { LogPersistLane } from "./interface";
 /**
  * Deterministic List.value for a log batch — retries after timeout map to the same row key.
  * SHA-256 over canonical JSON (service + process + lane + entries in order).
@@ -10,4 +10,4 @@ export declare function computeLogBatchIdempotencyKey(input: {
     lane: LogPersistLane;
     entries: LogEntry[];
 }): string;
-//# sourceMappingURL=log-persist-batch-id.d.ts.map
+//# sourceMappingURL=batch-id.d.ts.map

package/dist/shared/log/upload/batch-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-id.d.ts","sourceRoot":"","sources":["../../../../src/shared/log/upload/batch-id.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAoBlD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACvB,GAAG,MAAM,CAWT"}

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

@@ -0,0 +1,7 @@
+/** Master switch — env name kept for compatibility (`LOG_PERSIST_ENABLED`). */
+export declare function logSpoolEnabledFromEnv(env?: NodeJS.ProcessEnv): boolean;
+export declare function logPersistServiceFromEnv(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function logPersistProcessFromEnv(env?: NodeJS.ProcessEnv): string | undefined;
+/** `LOG_PERSIST_REGISTRY_DIR` or `RUNTIME_DATA_DIR`. */
+export declare function runtimeDataDirFromEnv(env?: NodeJS.ProcessEnv): string | undefined;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/shared/log/upload/env.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEpF;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAGjG;AAED,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAGjG;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAO9F"}

package/dist/shared/log/{log-persist-flush.d.ts → upload/flush.d.ts}

@@ -1,8 +1,8 @@
-import type { LogEntry } from "./log-manager";
-import type { BuildLogListDraftInput, LogListDraft } from "./log-persist.interface";
+import type { LogEntry } from "../core/log-manager";
+import type { BuildLogListDraftInput, LogListDraft } from "./interface";
 export declare function estimateEntriesBytes(entries: LogEntry[]): number;
 export declare function buildLogListDraft(input: BuildLogListDraftInput): LogListDraft;
 export declare function postLogBatch(draft: LogListDraft, postTimeoutMs: number): Promise<void>;
 /** Take a prefix of entries that fits within maxBytes. */
 export declare function takeEntriesWithinBytes(entries: LogEntry[], maxBytes: number): LogEntry[];
-//# sourceMappingURL=log-persist-flush.d.ts.map
+//# sourceMappingURL=flush.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flush.d.ts","sourceRoot":"","sources":["../../../../src/shared/log/upload/flush.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,CAShE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CA6B7E;AAoBD,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC5F;AAED,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAyBxF"}

package/dist/shared/log/{log-persist-hook.d.ts → upload/hook.d.ts}

@@ -1,6 +1,6 @@
-import type { LogEntry } from "./log-manager";
+import type { LogEntry } from "../core/log-manager";
 type LogPersistOfferFn = (entry: LogEntry) => void;
 export declare function registerLogPersistOffer(fn: LogPersistOfferFn | null): void;
 export declare function offerToLogPersist(entry: LogEntry): void;
 export {};
-//# sourceMappingURL=log-persist-hook.d.ts.map
+//# sourceMappingURL=hook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../../../src/shared/log/upload/hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAInD,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAE1E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEvD"}

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.11",
+    "version": "0.2.13",
     "description": "Supabase client initializer and data access APIs",
     "license": "MIT",
     "author": "KyLoc20",

package/src/browser.ts

@@ -28,7 +28,6 @@ export {
 } from "./extraction/extraction.api";
 export type { Extraction, ExtractionDetails } from "./extraction/extraction.interface";
 export { CategoryExtraction } from "./extraction/extraction.interface";
-export * from "./idea/idea.interface";
 export * from "./link/index";
 export * from "./list/index";
 export * from "./node/node.api";
@@ -172,6 +171,7 @@ export {
     registerServiceAtStartup,
     registrySlotRuntimePatchFromGuardResult,
     releaseSystemRegistrySlots,
+    releaseSystemRegistrySlotsByServiceId,
     resetSystemRegistryConfig,
     resetSystemRegistryConfigSchema,
     resolveActiveRegistryServiceId,
@@ -214,10 +214,13 @@ export {
     isLogBatchList,
     isLogEntry,
     LOG_BATCH_LOADER_KEY,
+    LOG_MIN_LEVEL_ENV_KEY,
     LOG_PERSIST_LOADER_KEY,
     LogLevel,
     logManager,
+    logMinLevelFromEnv,
     parseLogBatchMeta,
+    resolveLogMinLevel,
 } from "./shared/log";
 export { isHttpUrl, resolveFetchUrl } from "./shared/utils/fetch-url";
 export { getValueAtPath } from "./shared/utils/get-value-at-path";

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

@@ -1,12 +1,15 @@
 import { resolve } from "node:path";
-import { validateLogPersistPreloadEnv } from "../../shared/log/enable-log-persist";
-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;
     }
 
@@ -20,6 +23,19 @@ 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 {
+    if (options.applyLogMinLevel === false) {
+        return;
+    }
+    logManager.setOptions({
+        minLevel: resolveLogMinLevel({ defaultLevel: options.defaultLogMinLevel }),
+    });
 }
 
 /**
@@ -28,6 +44,7 @@ function applyServiceEnvDefaults(projectRoot: string, options: ServicePreloadOpt
  * Phase 1 — Resolve project root from service package name
  * Phase 2 — Load env files (`.env.local` / `.env`, or `.env.prod` when `--prod`)
  * Phase 3 — Apply SDK service env defaults + optional L3 hook
+ * Phase 3½ — Apply LOG_MIN_LEVEL → logManager.minLevel (after env load)
  * Phase 4 — Validate log-persist env when enabled
  * Phase 5 — Process diagnostics (TODO)
  *
@@ -42,7 +59,9 @@ export function runServicePreload(options: ServicePreloadOptions): void {
     applyServiceEnvDefaults(projectRoot, options);
     options.applyEnvDefaults?.(projectRoot);
 
-    validateLogPersistPreloadEnv();
+    applyLogMinLevelFromEnv(options);
+
+    validateLogSpoolPreloadEnv();
 
     // TODO: Phase 5 — optional unhandledRejection / uncaughtException formatters
     // (formerly watch-service preload-diagnostics.mjs)

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

@@ -1,3 +1,5 @@
+import type { LogLevel } from "../../shared/log/core/log-manager";
+
 export interface ServicePreloadOptions {
     /** `import.meta.url` from the service `scripts/preload.mjs`. */
     callerImportMetaUrl: string;
@@ -11,4 +13,10 @@ export interface ServicePreloadOptions {
     afterLoadEnv?: () => void;
     /** L3 hook after SDK defaults (legacy aliases, etc.). */
     applyEnvDefaults?: (projectRoot: string) => void;
+    /** Default when `LOG_MIN_LEVEL` unset; SDK default is DEBUG in dev, INFO in prod. */
+    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/service-guard/service-guard-node.ts

@@ -1,4 +1,5 @@
 import type { LoggerWithScope } from "../../shared/log";
+import { registerCollectLogRunner } from "../../shared/log/spool/register-collect-log-runner";
 import { TriggerNode } from "../../trigger/trigger-node";
 import { registerServiceGuardRunner } from "./register-service-guard-runner";
 import { runReadinessGate } from "./run-readiness-gate";
@@ -28,6 +29,10 @@ class ServiceGuardNode extends TriggerNode {
             logTopic: options.logTopic,
             ...options.guardRunner,
         });
+        registerCollectLogRunner({
+            serviceValue: options.serviceValue,
+            getServiceId: options.guardRunner.getServiceId,
+        });
         return new ServiceGuardNode(options);
     }
 

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

@@ -1,3 +1,7 @@
+export {
+    COLLECT_LOG_RUNNER_KEY,
+    registerCollectLogRunner,
+} from "../../shared/log/spool/register-collect-log-runner";
 export type {
     RegisterServiceGuardRunnerOptions,
     RunReadinessGateInput,

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

@@ -1,6 +1,9 @@
 import { createLogger, type Service, ServiceRegistryError } from "../../browser";
 import { claimServiceRegistrySlot, type ServiceRegistrySession } from "../../service/registry-lifecycle";
 import type { LoggerWithScope } from "../../shared/log";
+import { LOG_SPOOL_SERVICE_ID_ENV } from "../../shared/log/spool/config";
+import { ensureLogSpoolFromEnv } from "../../shared/log/spool/enable";
+import { logSpoolEnabledFromEnv } from "../../shared/log/upload/env";
 import type { ManagedChildProcesses } from "../process/managed-child-processes";
 
 export interface ServiceHostClosable {
@@ -10,6 +13,8 @@ export interface ServiceHostClosable {
 export interface ServiceHostContext {
     service: Service;
     session: ServiceRegistrySession;
+    /** Registry instance id — same as `service.id`; children inherit via spawn env injection. */
+    serviceId: string;
 }
 
 export interface ServiceHostOptions {
@@ -23,9 +28,11 @@ export interface ServiceHostOptions {
     prepare?: () => Promise<void>;
     createInstance: () => Promise<Service | { service: Service; baseUrl?: string }>;
     onRegistryClaimed?: (ctx: ServiceHostContext) => Promise<void>;
-    startSupervisors?: () => void | Promise<void>;
+    startSupervisors?: (ctx: ServiceHostContext) => void | Promise<void>;
     waitUntilReady?: () => Promise<void>;
     startServer?: () => Promise<ServiceHostClosable>;
+    /** When true (default), enable file log spool for main after registry claim. */
+    enableLogSpoolAfterClaim?: boolean;
     /** Stop child processes and other local resources (not registry release). */
     onShutdown?: (signal: string) => Promise<void>;
 }
@@ -121,12 +128,24 @@ export function createServiceHost(options: ServiceHostOptions): ServiceHost {
             throw error;
         }
 
+        const hostCtx: ServiceHostContext = { service: session.service, session, serviceId: session.service.id };
+
         if (options.onRegistryClaimed != null) {
-            await options.onRegistryClaimed({ service: session.service, session });
+            await options.onRegistryClaimed(hostCtx);
+        }
+
+        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,
+                processRole: "main",
+            });
         }
 
         if (options.startSupervisors != null) {
-            await options.startSupervisors();
+            await options.startSupervisors(hostCtx);
         }
 
         if (options.waitUntilReady != null) {

package/src/node.ts

@@ -122,9 +122,11 @@ export type {
 } from "./node/service-host";
 export {
     applyRegistrySlotGuardStep,
+    COLLECT_LOG_RUNNER_KEY,
     createServiceHost,
     getWorkerSpawnCooldownLastAt,
     markWorkerSpawned,
+    registerCollectLogRunner,
     registerServiceGuardRunner,
     runReadinessGate,
     runServiceGuardTick,
@@ -133,27 +135,32 @@ export {
     ServiceGuardNode,
 } from "./node/service-host";
 export { RepoManager } from "./repo/repo-manager";
+export { runCollectLogTick } from "./shared/log/spool/collector";
+export { LOG_SPOOL_SERVICE_ID_ENV } from "./shared/log/spool/config";
+export type { LogSpoolCoordinator, LogSpoolCoordinatorOptions } from "./shared/log/spool/coordinator";
+export { createLogSpoolCoordinator } from "./shared/log/spool/coordinator";
 export {
-    disableLogPersist,
-    enableLogPersist,
-    ensureLogPersistFromEnv,
-    getLogPersistStats,
-    logPersistEnabledFromEnv,
-    resolveLogPersistRegistryPath,
-    snapshotLogPersistReady,
-    validateLogPersistPreloadEnv,
-    waitForLogPersistReady,
-} from "./shared/log/enable-log-persist";
+    buildLogSpoolSpawnEnv,
+    ensureLogSpoolFromEnv,
+    getLogSpoolStats,
+    logSpoolEnabledFromEnv,
+    shutdownLogSpoolFromEnv,
+    validateLogSpoolPreloadEnv,
+} from "./shared/log/spool/enable";
 export type {
-    EnableLogPersistOptions,
-    EnsureLogPersistFromEnvOptions,
-    LogPersistLane,
-    LogPersistReadySnapshot,
-    LogPersistStats,
-    WaitForLogPersistReadyOptions,
-} from "./shared/log/log-persist.interface";
-export type { LogPersistCoordinator, LogPersistCoordinatorOptions } from "./shared/log/log-persist-coordinator";
-export { createLogPersistCoordinator } from "./shared/log/log-persist-coordinator";
+    EnableLogSpoolOptions,
+    LogSpoolCoreProcessRole,
+    LogSpoolProcessRole,
+    LogSpoolWriterStats,
+} from "./shared/log/spool/interface";
+export { resolveLogSpoolRoot } from "./shared/log/spool/paths";
+export {
+    enableLogSpoolFromEnvInChild,
+    getMainLogSpoolWriterStats,
+    isLogSpoolEnabled,
+    shutdownLogSpool,
+} from "./shared/log/spool/service-lifecycle";
+export type { LogBatchMeta, LogPersistLane } from "./shared/log/upload/interface";
 export type {
     ConfigSchema,
     LoadCachedJsConfigOptions,

package/src/resource/resource.interface.ts

@@ -0,0 +1,37 @@
+import type { Target } from "../core.interface";
+
+export enum CategoryResource {
+    RESOURCE = "resource",
+}
+
+export interface Resource extends Target {
+    /** For now same to value */
+    name: string;
+    /** Unique id, "vultr:149.28.16.125" */
+    value: string;
+    category: CategoryResource;
+    details: ResourceDetails;
+}
+
+export interface ResourceDetails {
+    manifestVersion: 0;
+    /**  "vultr-vps" | "supabase-project" | "telegram-storage" */
+    loaderKey: string;
+    meta: unknown;
+    runtime: unknown;
+}
+
+// {
+//     name: "windows-storage:DESKTOP-K32MS2Q",
+//     value: "windows-storage:DESKTOP-K32MS2Q",
+//     category: CategoryResource.RESOURCE,
+//     tagList: [],
+//     details: {
+//       manifestVersion: 0,
+//       loaderKey: "windows-storage",
+//       meta: {
+//         hostname: "DESKTOP-K32MS2Q",
+//       },
+//       runtime: {},
+//     },
+//   }

package/src/service/config.api.ts

@@ -61,6 +61,7 @@ export const DEFAULT_SYSTEM_REGISTRY_SEED_SLOTS: readonly SystemRegistrySeedSlot
     { serviceValue: "storage-service" },
     { serviceValue: "gc-service" },
     { serviceValue: "upload-service" },
+    { serviceValue: "cv-service" },
 ] as const;
 
 const configCategoryFilter: QueryFilter = {

package/src/service/index.ts

@@ -35,6 +35,8 @@ export type {
     PatchServiceRuntimeInput,
     RegisterServiceInput,
     ReleasedRegistrySlot,
+    ReleaseSystemRegistrySlotsByServiceIdInput,
+    ReleaseSystemRegistrySlotsByServiceIdOutcome,
     ReleaseSystemRegistrySlotsInput,
     ReleaseSystemRegistrySlotsOutcome,
     TargetSystemRegistrySlotView,
@@ -51,6 +53,7 @@ export {
     registerService,
     registerServiceAtStartup,
     releaseSystemRegistrySlots,
+    releaseSystemRegistrySlotsByServiceId,
     resolveActiveRegistryServiceId,
     ServiceRegistryError,
     unregisterService,