target-supabase-sdk 0.2.2 → 0.2.4

package/dist/extraction/extraction.api.d.ts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+import type { SupabaseResponse } from "../core.interface";
+import { type Extraction } from "./extraction.interface";
+export declare const postExtractionSchema: z.ZodObject<{
+    name: z.ZodString;
+    /** Source Target id — for log analysis this is the producing Task id. */
+    sourceId: z.ZodString;
+    loaderKey: z.ZodString;
+    meta: z.ZodOptional<z.ZodUnknown>;
+    objects: z.ZodArray<z.ZodUnknown, "many">;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    extra: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tagList: string[];
+    sourceId: string;
+    loaderKey: string;
+    objects: unknown[];
+    extra?: string | undefined;
+    meta?: unknown;
+}, {
+    name: string;
+    sourceId: string;
+    loaderKey: string;
+    objects: unknown[];
+    tagList?: string[] | undefined;
+    extra?: string | undefined;
+    meta?: unknown;
+}>;
+export type PostExtractionPayload = z.infer<typeof postExtractionSchema>;
+export declare const getExtractionSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    loaderKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}>, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}, {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}>;
+export type GetExtractionPayload = z.infer<typeof getExtractionSchema>;
+export declare const scanExtractionListSchema: z.ZodObject<{
+    loaderKey: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    ascending: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    ascending?: boolean | undefined;
+    maxRows?: number | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}, {
+    ascending?: boolean | undefined;
+    maxRows?: number | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}>;
+export type ScanExtractionListPayload = z.infer<typeof scanExtractionListSchema>;
+export declare const patchExtractionObjectsSchema: z.ZodObject<{
+    id: z.ZodString;
+    objects: z.ZodArray<z.ZodUnknown, "many">;
+    meta: z.ZodOptional<z.ZodUnknown>;
+    expectedRevision: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    objects: unknown[];
+    meta?: unknown;
+    expectedRevision?: number | undefined;
+}, {
+    id: string;
+    objects: unknown[];
+    meta?: unknown;
+    expectedRevision?: number | undefined;
+}>;
+export type PatchExtractionObjectsPayload = z.infer<typeof patchExtractionObjectsSchema>;
+/** Create an Extraction row for `(sourceId, loaderKey)`. Idempotent on redundancy key. */
+export declare const postExtraction: (payload: {
+    name: string;
+    tagList: string[];
+    sourceId: string;
+    loaderKey: string;
+    objects: unknown[];
+    extra?: string | undefined;
+    meta?: unknown;
+}) => SupabaseResponse<Extraction> | Promise<SupabaseResponse<Extraction>>;
+/** Fetch one Extraction by row id, or by `(sourceId, loaderKey)`. */
+export declare const getExtraction: (payload: {
+    id?: string | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}) => SupabaseResponse<Extraction> | Promise<SupabaseResponse<Extraction>>;
+/** Scan Extraction rows (newest first by default). */
+export declare const scanExtractionList: (payload: {
+    ascending?: boolean | undefined;
+    maxRows?: number | undefined;
+    sourceId?: string | undefined;
+    loaderKey?: string | undefined;
+}) => SupabaseResponse<Extraction[]> | Promise<SupabaseResponse<Extraction[]>>;
+/** Replace {@link ExtractionDetails.objects} and bump `meta.revision`. */
+export declare const patchExtractionObjects: (payload: {
+    id: string;
+    objects: unknown[];
+    meta?: unknown;
+    expectedRevision?: number | undefined;
+}) => SupabaseResponse<Extraction> | Promise<SupabaseResponse<Extraction>>;
+//# sourceMappingURL=extraction.api.d.ts.map

package/dist/extraction/extraction.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.api.d.ts","sourceRoot":"","sources":["../../src/extraction/extraction.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAsB,KAAK,UAAU,EAA0B,MAAM,wBAAwB,CAAC;AAKrG,eAAO,MAAM,oBAAoB;;IAE7B,yEAAyE;;;;;;;;;;;;;;;;;;;;;;;EAO3E,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;EAgB3B,CAAC;AAEN,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEvE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAKnC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;EAKvC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AA8BzF,0FAA0F;AAC1F,eAAO,MAAM,cAAc;;;;;;;;0EAmCzB,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;0EA2BxB,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,kBAAkB;;;;;8EAkB7B,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB;;;;;0EA2CjC,CAAC"}

package/dist/extraction/extraction.interface.d.ts

@@ -0,0 +1,43 @@
+import type { Target } from "../core.interface";
+/**
+ * Interpretation layer for a source Target: pipeline output (systems, models, algorithms)
+ * materialized as structured data. Not a process (see Task) or raw bytes (see Parcel).
+ *
+ * @see `.cursor/skills/extraction/SKILL.md`
+ */
+export interface Extraction extends Target {
+    /** Human-readable label. */
+    name: string;
+    /**
+     * Source Target id — the single input this row interprets (any category).
+     * Immutable after create. Indexed for lookup: all Extractions where `value = sourceId`.
+     * Not a dedup hash or pipeline run id.
+     */
+    value: string;
+    category: CategoryExtraction;
+    details: ExtractionDetails;
+}
+export declare enum CategoryExtraction {
+    EXTRACTION = "extraction"
+}
+export interface ExtractionDetails {
+    manifestVersion: 0;
+    /**
+     * Extractor identifier. Together with {@link Extraction.value} (source id) forms the
+     * logical unique key: one Extraction row per `(sourceTargetId, loaderKey)`.
+     * Determines how to parse and render {@link objects} (Extractor-owned schema).
+     */
+    loaderKey: string;
+    /**
+     * Extractor-owned metadata for this interpretation (e.g. revision, updatedAt, pipeline).
+     * Updated alongside {@link objects}; kept `unknown` at SDK boundary — see Extractor module.
+     */
+    meta: unknown;
+    /**
+     * Latest mutable analysis results for this source + Extractor — not an immutable snapshot.
+     * Shape is defined by the Extractor for {@link loaderKey}; SDK keeps `unknown[]` at core.
+     * Large payloads should reference Parcel (or similar) rather than inline in this array.
+     */
+    objects: Array<unknown>;
+}
+//# sourceMappingURL=extraction.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.interface.d.ts","sourceRoot":"","sources":["../../src/extraction/extraction.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,UAAW,SAAQ,MAAM;IACtC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,iBAAiB,CAAC;CAC9B;AAED,oBAAY,kBAAkB;IAC1B,UAAU,eAAe;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,eAAe,EAAE,CAAC,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;;;OAIG;IACH,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CAC3B"}

package/dist/list/list.interface.d.ts

@@ -10,8 +10,8 @@ export interface List extends Target {
 }
 export interface ListDetails {
     manifestVersion: number;
-    /** If string, it is the meta brief of the list, TODO */
-    meta: string;
+    /** Optional list metadata (shape depends on `loaderKey`). */
+    meta: unknown;
     /** If string, it is the url of the preview TODO */
     preview: string;
     /** How to render the List */

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

@@ -1 +1 @@
-{"version":3,"file":"list.interface.d.ts","sourceRoot":"","sources":["../../src/list/list.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,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,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB"}
+{"version":3,"file":"list.interface.d.ts","sourceRoot":"","sources":["../../src/list/list.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,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,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB"}

package/dist/node/env/index.d.ts

@@ -2,8 +2,8 @@ export type { EnvIntOptions, EnvNumberOptions } from "./env-parsers";
 export { envBool, envInt, envMs, envNumber, envPort } from "./env-parsers";
 export type { InitSupabaseFromStandardEnvOptions } from "./init-supabase-from-env";
 export { initSupabaseFromStandardEnv } from "./init-supabase-from-env";
-export type { LoadEnvFilesOptions } from "./load-env";
-export { loadEnvFiles, parseEnvFile, parseEnvFileContent, parseEnvLine } from "./load-env";
+export type { EnvProfileFromProcessOptions, LoadEnvFilesOptions } from "./load-env";
+export { CLI_PROD_FLAG, envProfileFromProcess, loadEnvFiles, parseEnvFile, parseEnvFileContent, parseEnvLine, pinEnvProfileFromArgv, resolveDefaultEnvFiles, SERVICE_ENV_PROFILE_ENV_KEY, SERVICE_ENV_PROFILE_PROD, } from "./load-env";
 export { resolveProjectRootByPackageName, resolveProjectRootFromModule } from "./project-root";
 export type { PublicBaseUrlFromEnvOptions } from "./public-base-url";
 export { publicBaseUrlFromEnv } from "./public-base-url";

package/dist/node/env/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/env/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/env/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC3E,YAAY,EAAE,kCAAkC,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,EACH,aAAa,EACb,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,2BAA2B,EAC3B,wBAAwB,GAC3B,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,+BAA+B,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/node/env/init-supabase-from-env.d.ts

@@ -1,7 +1,7 @@
 export interface InitSupabaseFromStandardEnvOptions {
     /** Project root for `.env` files (required when `loadEnv` is true). */
     root?: string;
-    /** Load `.env.local` / `.env` before initialize (default true). */
+    /** Load env files before initialize (default true). Uses `.env.prod` when profile is `prod`. */
     loadEnv?: boolean;
     /** Hook after env files loaded (legacy aliases, etc.). */
     afterLoadEnv?: () => void;

package/dist/node/env/init-supabase-from-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-supabase-from-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/init-supabase-from-env.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kCAAkC;IAC/C,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjH"}
+{"version":3,"file":"init-supabase-from-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/init-supabase-from-env.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kCAAkC;IAC/C,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,kCAAuC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjH"}

package/dist/node/env/load-env.d.ts

@@ -1,3 +1,16 @@
+export declare const SERVICE_ENV_PROFILE_ENV_KEY: "SERVICE_ENV_PROFILE";
+export declare const SERVICE_ENV_PROFILE_PROD: "prod";
+export declare const CLI_PROD_FLAG: "--prod";
+export interface EnvProfileFromProcessOptions {
+    env?: NodeJS.ProcessEnv;
+    argv?: readonly string[];
+}
+/** Resolve active env profile from `SERVICE_ENV_PROFILE` or `--prod` on argv. */
+export declare function envProfileFromProcess(options?: EnvProfileFromProcessOptions): string | undefined;
+/** Default env file list for a profile (`prod` → `.env.prod`; otherwise `.env.local` → `.env`). */
+export declare function resolveDefaultEnvFiles(profile?: string): readonly string[];
+/** Pin `SERVICE_ENV_PROFILE=prod` when `--prod` is on argv (for child process inheritance). */
+export declare function pinEnvProfileFromArgv(env?: NodeJS.ProcessEnv, argv?: readonly string[]): void;
 export interface LoadEnvFilesOptions {
     /** Files to load in order (later files do not override existing env). */
     files?: readonly string[];
@@ -13,7 +26,8 @@ export declare function parseEnvLine(line: string): {
 export declare function parseEnvFileContent(content: string, env: NodeJS.ProcessEnv): void;
 export declare function parseEnvFile(filePath: string, env: NodeJS.ProcessEnv): void;
 /**
- * Load `.env.local` then `.env` into `process.env` (or `options.env`).
+ * Load env files into `process.env` (or `options.env`).
+ * Default files: `.env.local` → `.env`, or `.env.prod` when profile is `prod` / `--prod`.
  * Existing non-empty env values are not overwritten.
  */
 export declare function loadEnvFiles(root: string, options?: LoadEnvFilesOptions): void;

package/dist/node/env/load-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/load-env.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAChC,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAMD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAchF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAUjF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAK3E;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAS9E"}
+{"version":3,"file":"load-env.d.ts","sourceRoot":"","sources":["../../../src/node/env/load-env.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,2BAA2B,EAAG,qBAA8B,CAAC;AAC1E,eAAO,MAAM,wBAAwB,EAAG,MAAe,CAAC;AACxD,eAAO,MAAM,aAAa,EAAG,QAAiB,CAAC;AAE/C,MAAM,WAAW,4BAA4B;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,MAAM,GAAG,SAAS,CAWhG;AAED,mGAAmG;AACnG,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAK1E;AAED,+FAA+F;AAC/F,wBAAgB,qBAAqB,CACjC,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,IAAI,GAAE,SAAS,MAAM,EAAiB,GACvC,IAAI,CAON;AAED,MAAM,WAAW,mBAAmB;IAChC,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAMD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAchF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAUjF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAK3E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAS9E"}

package/dist/node/node-runtime.base.d.ts

@@ -5,6 +5,15 @@ export interface NodeLoopContext {
     loopTraceId: string;
     nodeId: string;
 }
+/** Shared options for {@link BaseNodeRuntime} and subclasses (e.g. TriggerNode). */
+export interface BaseNodeRuntimeOptions {
+    /**
+     * Called after node logout (or when the node was never registered),
+     * immediately before `process.exit`. Use for best-effort cleanup such as
+     * {@link unregisterServiceAtShutdown}. Errors are logged and ignored.
+     */
+    beforeProcessExit?: () => void | Promise<void>;
+}
 export declare const LOG_TOPIC_NODE = "node";
 /**
  * Shared node process runtime: bootstrap, main-loop frame, heartbeat, commands, shutdown.
@@ -15,6 +24,7 @@ declare abstract class BaseNodeRuntime {
     /** Log `nodeId` label while startup has not yet received an assigned id from Supabase. */
     private static readonly NODE_ID_PENDING_ASSIGNMENT;
     protected readonly runtimeModule: string;
+    private readonly beforeProcessExitHook;
     private _localNodeId;
     private _isNodeIdLocked;
     private isRunning;
@@ -26,7 +36,9 @@ declare abstract class BaseNodeRuntime {
     private startPromise;
     get localNodeId(): string | null;
     protected set localNodeId(value: string);
-    protected constructor(runtimeModule: string);
+    protected constructor(runtimeModule: string, options?: BaseNodeRuntimeOptions);
+    private runBeforeProcessExit;
+    private exitProcess;
     /** Hook: task registration, trigger config load, etc. Throw to abort bootstrap. */
     protected abstract onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
     /** Hook: one iteration body after commands + heartbeat gate. */

package/dist/node/node-runtime.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-runtime.base.d.ts","sourceRoot":"","sources":["../../src/node/node-runtime.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAGH,KAAK,eAAe,EACpB,QAAQ,EAIX,MAAM,eAAe,CAAC;AAMvB,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AAIrC;;;GAGG;AACH,uBAAe,eAAe;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,KAAK;IAC1D,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;IAEvE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAEzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAA8B;IAElD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAUtC;IAED,SAAS,aAAa,aAAa,EAAE,MAAM;IAQ3C,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/E,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1F,iGAAiG;IACjG,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC,wEAAwE;IACxE,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,OAAO,CAAC,YAAY;IAIpB,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,wBAAwB;IAsD1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,QAAQ;YAsER,OAAO;IAoDf,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B/C,WAAW;IAoCnB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDjD,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DvD,uFAAuF;cACvE,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrF;;;OAGG;cACa,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7F;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"node-runtime.base.d.ts","sourceRoot":"","sources":["../../src/node/node-runtime.base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAGH,KAAK,eAAe,EACpB,QAAQ,EAIX,MAAM,eAAe,CAAC;AAMvB,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,cAAc,SAAS,CAAC;AAIrC;;;GAGG;AACH,uBAAe,eAAe;IAC1B,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,KAAK;IAC1D,0FAA0F;IAC1F,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;IAEvE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAsC;IAE5E,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,4BAA4B,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAW;IACxC,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,YAAY,CAA8B;IAElD,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAUtC;IAED,SAAS,aAAa,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;YAS/D,oBAAoB;YAcpB,WAAW;IAKzB,mFAAmF;IACnF,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAE/E,gEAAgE;IAChE,SAAS,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1F,iGAAiG;IACjG,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC,wEAAwE;IACxE,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC,OAAO,CAAC,YAAY;IAIpB,SAAS,CAAC,cAAc,IAAI,OAAO;IAInC,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,OAAO,CAAC,wBAAwB;IAsD1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAQd,QAAQ;YAsER,OAAO;IAoDf,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YA6B/C,WAAW;IAoCnB,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAkDjD,YAAY,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DvD,uFAAuF;cACvE,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrF;;;OAGG;cACa,kBAAkB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7F;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/node/preload/run-service-preload.d.ts

@@ -3,7 +3,7 @@ import type { ServicePreloadOptions } from "./service-preload.interface";
  * Unified Node `--import` preload runner (sync only).
  *
  * Phase 1 — Resolve project root from service package name
- * Phase 2 — Load `.env.local` / `.env`
+ * Phase 2 — Load env files (`.env.local` / `.env`, or `.env.prod` when `--prod`)
  * Phase 3 — Apply SDK service env defaults + optional L3 hook
  * Phase 4 — Validate log-persist env when enabled
  * Phase 5 — Process diagnostics (TODO)

package/dist/node/preload/run-service-preload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-service-preload.d.ts","sourceRoot":"","sources":["../../../src/node/preload/run-service-preload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAmBzE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAYtE"}
+{"version":3,"file":"run-service-preload.d.ts","sourceRoot":"","sources":["../../../src/node/preload/run-service-preload.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAmBzE;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAatE"}

package/dist/node/process/create-managed-child-processes.d.ts

@@ -0,0 +1,12 @@
+import type { ManagedChildProcessesOptions } from "./managed-child-processes";
+import { ManagedChildProcesses } from "./managed-child-processes";
+export type CreateManagedChildProcessesOptions = Pick<ManagedChildProcessesOptions, "projectRoot" | "preloadModules" | "useTsx" | "graceMs"> & {
+    /** Defaults to `createLogger({ module: "launcher" })`. */
+    logger?: ManagedChildProcessesOptions["logger"];
+};
+/**
+ * Standard L3 service child-process registry: node (not tsx), service preload, launcher logger.
+ * Each service keeps a singleton in `src/startup/child-processes.ts`.
+ */
+export declare function createManagedChildProcesses(options: CreateManagedChildProcessesOptions): ManagedChildProcesses;
+//# sourceMappingURL=create-managed-child-processes.d.ts.map

package/dist/node/process/create-managed-child-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/create-managed-child-processes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,MAAM,kCAAkC,GAAG,IAAI,CACjD,4BAA4B,EAC5B,aAAa,GAAG,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAC1D,GAAG;IACA,0DAA0D;IAC1D,MAAM,CAAC,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;CACnD,CAAC;AAIF;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kCAAkC,GAAG,qBAAqB,CAQ9G"}

package/dist/node/process/index.d.ts

@@ -1,4 +1,6 @@
-export type { ManagedChildProcessesOptions, SpawnChildResult, StopAllChildrenOptions, } from "./managed-child-processes";
+export type { CreateManagedChildProcessesOptions } from "./create-managed-child-processes";
+export { createManagedChildProcesses } from "./create-managed-child-processes";
+export type { CriticalExitHandler, ManagedChildProcessesOptions, SpawnChildOptions, SpawnChildResult, StopAllChildrenOptions, } from "./managed-child-processes";
 export { ManagedChildProcesses } from "./managed-child-processes";
 export type { BuildNodeImportArgsInput, SpawnTsxChildOptions } from "./process-spawn";
 export { buildNodeImportArgs, isChildProcessRunning, spawnTsxChild } from "./process-spawn";

package/dist/node/process/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/process/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/process/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EACR,mBAAmB,EACnB,4BAA4B,EAC5B,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,YAAY,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/node/process/managed-child-processes.d.ts

@@ -5,7 +5,12 @@ export interface ManagedChildProcessesOptions {
     preloadModules?: readonly string[];
     /** SIGTERM -> wait -> SIGKILL delay (default 5000 ms). */
     graceMs?: number;
-    logger?: Pick<LoggerWithScope, "info" | "warn" | "error">;
+    logger?: Pick<LoggerWithScope, "info" | "warn" | "error" | "critical">;
+    useTsx?: boolean;
+}
+export interface SpawnChildOptions {
+    env?: Record<string, string>;
+    useTsx?: boolean;
 }
 export interface SpawnChildResult {
     child: ChildProcess;
@@ -16,6 +21,10 @@ export interface StopAllChildrenOptions {
     /** PIDs to SIGTERM when not tracked by this registry (cross-process cleanup). */
     extraPids?: readonly number[];
 }
+export interface CriticalExitHandler {
+    labels: readonly string[];
+    onCriticalExit: (label: string, code: number | null, signal: NodeJS.Signals | null) => void;
+}
 /**
  * Process-local registry for tsx child processes (supervisor, worker, etc.).
  * Each OS process has its own instance - do not expect cross-process PID tracking.
@@ -24,13 +33,17 @@ export declare class ManagedChildProcesses {
     private readonly projectRoot;
     private readonly preloadModules;
     private readonly graceMs;
+    private readonly defaultUseTsx;
     private readonly logger?;
     private readonly byLabel;
+    private criticalExitHandler;
+    private suppressCriticalExit;
     constructor(options: ManagedChildProcessesOptions);
+    setCriticalExitHandler(handler: CriticalExitHandler): void;
     get(label: string): ChildProcess | null;
     getRunning(label: string): ChildProcess | null;
     runningLabels(): string[];
-    spawn(label: string, entryScript: string): SpawnChildResult;
+    spawn(label: string, entryScript: string, spawnOptions?: SpawnChildOptions): SpawnChildResult;
     stopAll(options?: StopAllChildrenOptions): Promise<void>;
     private stopChild;
 }

package/dist/node/process/managed-child-processes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/managed-child-processes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAmD;IAC3E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,OAAO,EAAE,4BAA4B;IAOjD,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIvC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK9C,aAAa,IAAI,MAAM,EAAE;IAMzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAkCrD,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D,OAAO,CAAC,SAAS;CAWpB"}
+{"version":3,"file":"managed-child-processes.d.ts","sourceRoot":"","sources":["../../../src/node/process/managed-child-processes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,MAAM,WAAW,4BAA4B;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC,CAAC;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,YAAY,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,iFAAiF;IACjF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;CAC/F;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAoB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAgE;IACxF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,oBAAoB,CAAS;gBAEzB,OAAO,EAAE,4BAA4B;IAQjD,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAI1D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIvC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAK9C,aAAa,IAAI,MAAM,EAAE;IAMzB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,iBAAiB,GAAG,gBAAgB;IA2CvF,OAAO,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB9D,OAAO,CAAC,SAAS;CAWpB"}

package/dist/node/runtime-state/create-service-runtime-state-store.d.ts

@@ -0,0 +1,23 @@
+import { type JsonStatePatch } from "../fs/json-state-store";
+import type { DefaultExtraRuntimeSlices, ServiceRuntimeExtraSlicePatch, ServiceRuntimeNestedKeys, ServiceRuntimeState } from "./service-runtime-state.types";
+export interface CreateServiceRuntimeStateStoreOptions<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> {
+    filePath: string;
+    /** Default values for service-specific top-level nested slices. */
+    extraDefaults?: TExtraSlices;
+}
+export interface FinishRunnerTickOptions<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> {
+    nowMs: number;
+    lastFired: Record<string, string>;
+    postedCount?: number;
+    /** Patch extra slices in the same atomic write as the scheduler tick. */
+    extra?: ServiceRuntimeExtraSlicePatch<TExtraSlices>;
+}
+export interface ServiceRuntimeStateStore<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> {
+    readRuntimeState(): Promise<ServiceRuntimeState<TExtraSlices>>;
+    writeRuntimeState(patch: JsonStatePatch<ServiceRuntimeState<TExtraSlices>, ServiceRuntimeNestedKeys<TExtraSlices>>): Promise<ServiceRuntimeState<TExtraSlices>>;
+    resetRuntimeStateForStartup(): Promise<ServiceRuntimeState<TExtraSlices>>;
+    finishRunnerTick(options: FinishRunnerTickOptions<TExtraSlices>): Promise<void>;
+}
+/** JSON file-backed service runtime state (L3 blueprint) with typed core slices and extensions. */
+export declare function createServiceRuntimeStateStore<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices>(options: CreateServiceRuntimeStateStoreOptions<TExtraSlices>): ServiceRuntimeStateStore<TExtraSlices>;
+//# sourceMappingURL=create-service-runtime-state-store.d.ts.map

package/dist/node/runtime-state/create-service-runtime-state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-service-runtime-state-store.d.ts","sourceRoot":"","sources":["../../../src/node/runtime-state/create-service-runtime-state-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAqD,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChH,OAAO,KAAK,EACR,yBAAyB,EAIzB,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EAEtB,MAAM,+BAA+B,CAAC;AAIvC,MAAM,WAAW,qCAAqC,CAClD,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB;IAEvE,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,aAAa,CAAC,EAAE,YAAY,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,KAAK,CAAC,EAAE,6BAA6B,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,wBAAwB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB;IAC7G,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/D,iBAAiB,CACb,KAAK,EAAE,cAAc,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC,YAAY,CAAC,CAAC,GACjG,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC9C,2BAA2B,IAAI,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1E,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnF;AA0CD,mGAAmG;AACnG,wBAAgB,8BAA8B,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB,EAClH,OAAO,EAAE,qCAAqC,CAAC,YAAY,CAAC,GAC7D,wBAAwB,CAAC,YAAY,CAAC,CAyCxC"}

package/dist/node/runtime-state/index.d.ts

@@ -0,0 +1,4 @@
+export type { CreateServiceRuntimeStateStoreOptions, FinishRunnerTickOptions, ServiceRuntimeStateStore, } from "./create-service-runtime-state-store";
+export { createServiceRuntimeStateStore } from "./create-service-runtime-state-store";
+export type { GuardRuntimeSlice, ReadinessRuntimeSlice, ReadinessStatus, SchedulerRuntimeSlice, ServiceRuntimeCoreNestedKey, ServiceRuntimeExtraSlicePatch, ServiceRuntimeNestedKeys, ServiceRuntimeState, WorkerRuntimeSlice, } from "./service-runtime-state.types";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/runtime-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/runtime-state/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACR,qCAAqC,EACrC,uBAAuB,EACvB,wBAAwB,GAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,sCAAsC,CAAC;AACtF,YAAY,EACR,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,GACrB,MAAM,+BAA+B,CAAC"}

package/dist/node/runtime-state/service-runtime-state.types.d.ts

@@ -0,0 +1,57 @@
+import type { RegistrySlotRuntimeState } from "../../service/registry-lifecycle";
+export type ReadinessStatus = "pending" | "passed" | "failed";
+export interface ReadinessRuntimeSlice {
+    status: ReadinessStatus;
+    checkedAt: string | null;
+    message: string | null;
+    checks: {
+        name: string;
+        ok: boolean;
+        detail?: string;
+    }[];
+}
+export interface GuardRuntimeSlice {
+    nodeId: string | null;
+    lastCheckAt: string | null;
+    lastDecision: string | null;
+    lastSpawnAt: string | null;
+    spawnCount: number;
+}
+export interface SchedulerRuntimeSlice {
+    lastTickAt: string | null;
+    lastPostedCount: number;
+    lastFired: Record<string, string>;
+}
+export interface WorkerRuntimeSlice {
+    pid: number | null;
+    spawnedAt: string | null;
+    ready: boolean;
+    registeredTasks: string[];
+    readyAt: string | null;
+}
+/**
+ * Default when an L3 service has no service-specific runtime state slices.
+ * Use an empty object type (not `Record<string, never>`) so intersecting with core
+ * slices does not add a string index signature that collapses property types to `never`.
+ */
+export type DefaultExtraRuntimeSlices = Record<never, never>;
+/**
+ * Cross-process service runtime state persisted to `state.json`.
+ * L3 blueprint: readiness + guard + scheduler + worker + registry.
+ * Extend via extra top-level slices only.
+ */
+export type ServiceRuntimeState<TExtraSlices extends Record<string, object> = DefaultExtraRuntimeSlices> = {
+    updatedAt: string;
+    readiness: ReadinessRuntimeSlice;
+    guard: GuardRuntimeSlice;
+    scheduler: SchedulerRuntimeSlice;
+    worker: WorkerRuntimeSlice;
+    registry: RegistrySlotRuntimeState;
+} & TExtraSlices;
+export type ServiceRuntimeCoreNestedKey = "readiness" | "guard" | "scheduler" | "worker" | "registry";
+export type ServiceRuntimeNestedKeys<TExtraSlices extends Record<string, object>> = ServiceRuntimeCoreNestedKey | (keyof TExtraSlices & string);
+/** Patch shape for extra top-level slices (one level deep). */
+export type ServiceRuntimeExtraSlicePatch<TExtraSlices extends Record<string, object>> = {
+    [K in keyof TExtraSlices]?: TExtraSlices[K] extends object ? Partial<TExtraSlices[K]> : TExtraSlices[K];
+};
+//# sourceMappingURL=service-runtime-state.types.d.ts.map

package/dist/node/runtime-state/service-runtime-state.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-runtime-state.types.d.ts","sourceRoot":"","sources":["../../../src/node/runtime-state/service-runtime-state.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IAClC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,yBAAyB,IAAI;IACvG,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,qBAAqB,CAAC;IACjC,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,qBAAqB,CAAC;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,wBAAwB,CAAC;CACtC,GAAG,YAAY,CAAC;AAEjB,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEtG,MAAM,MAAM,wBAAwB,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAC1E,2BAA2B,GAC3B,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC;AAEpC,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI;KACpF,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAC1G,CAAC"}

package/dist/node/service-guard/index.d.ts

@@ -0,0 +1,9 @@
+export { registerServiceGuardRunner } from "./register-service-guard-runner";
+export type { RunReadinessGateInput } from "./run-readiness-gate";
+export { runReadinessGate } from "./run-readiness-gate";
+export { runServiceGuardTick } from "./run-service-guard-tick";
+export type { RegisterServiceGuardRunnerOptions, ServiceGuardNodeOptions, ServiceGuardTickInput, ServiceGuardTickResult, } from "./service-guard.interface";
+export { SERVICE_GUARD_RUNNER_KEY } from "./service-guard.interface";
+export { ServiceGuardNode } from "./service-guard-node";
+export { getWorkerSpawnCooldownLastAt, markWorkerSpawned, resetWorkerSpawnCooldownForTests, } from "./worker-spawn-cooldown";
+//# sourceMappingURL=index.d.ts.map

package/dist/node/service-guard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACR,iCAAiC,EACjC,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACH,4BAA4B,EAC5B,iBAAiB,EACjB,gCAAgC,GACnC,MAAM,yBAAyB,CAAC"}

package/dist/node/service-guard/register-service-guard-runner.d.ts

@@ -0,0 +1,9 @@
+import { type RegisterServiceGuardRunnerOptions, SERVICE_GUARD_RUNNER_KEY } from "./service-guard.interface";
+export interface RegisterServiceGuardRunnerOptionsWithClock extends RegisterServiceGuardRunnerOptions {
+    /** Test hook — defaults to Date.now(). */
+    now?: () => number;
+}
+/** Register the standard L3 guard runner (registry slot + TaskNode + Service runtime). */
+export declare function registerServiceGuardRunner(options: RegisterServiceGuardRunnerOptionsWithClock): void;
+export { SERVICE_GUARD_RUNNER_KEY };
+//# sourceMappingURL=register-service-guard-runner.d.ts.map

package/dist/node/service-guard/register-service-guard-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-service-guard-runner.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/register-service-guard-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iCAAiC,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AA6C7G,MAAM,WAAW,0CAA2C,SAAQ,iCAAiC;IACjG,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0CAA0C,GAAG,IAAI,CAOpG;AAED,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/node/service-guard/run-readiness-gate.d.ts

@@ -0,0 +1,11 @@
+import type { LoggerWithScope } from "../../shared/log";
+import type { ReadinessCheck, ReadinessReport } from "../readiness/readiness.types";
+export interface RunReadinessGateInput {
+    checks: ReadinessCheck[];
+    onReport: (report: ReadinessReport) => Promise<void>;
+    logger: LoggerWithScope;
+    logTopic?: string;
+}
+/** Run readiness checks, persist report via callback, fail-fast when not ok. */
+export declare function runReadinessGate(input: RunReadinessGateInput): Promise<ReadinessReport>;
+//# sourceMappingURL=run-readiness-gate.d.ts.map

package/dist/node/service-guard/run-readiness-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-readiness-gate.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/run-readiness-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpF,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,gFAAgF;AAChF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqB7F"}

package/dist/node/service-guard/run-service-guard-tick.d.ts

@@ -0,0 +1,7 @@
+import type { ServiceGuardTickInput, ServiceGuardTickResult } from "./service-guard.interface";
+/**
+ * One guard-runner tick: registry slot check, TaskNode liveness, optional worker
+ * respawn, Service runtime heartbeat rollup.
+ */
+export declare function runServiceGuardTick(input: ServiceGuardTickInput): Promise<ServiceGuardTickResult>;
+//# sourceMappingURL=run-service-guard-tick.d.ts.map

package/dist/node/service-guard/run-service-guard-tick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-service-guard-tick.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/run-service-guard-tick.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAG/F;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgGvG"}

package/dist/node/service-guard/service-guard-node.d.ts

@@ -0,0 +1,18 @@
+import type { LoggerWithScope } from "../../shared/log";
+import { TriggerNode } from "../../trigger/trigger-node";
+import type { ServiceGuardNodeOptions } from "./service-guard.interface";
+/**
+ * L3 guard process TriggerNode: readiness gate, TaskNode worker spawn owner,
+ * and {@link registerServiceGuardRunner} tick (registry slot + liveness + runtime).
+ *
+ * Use {@link ServiceGuardNode.create} so the guard runner is registered before `start()`.
+ */
+declare class ServiceGuardNode extends TriggerNode {
+    private readonly options;
+    private constructor();
+    /** Register the guard runner and return a ready-to-start node. */
+    static create(options: ServiceGuardNodeOptions): ServiceGuardNode;
+    protected onBeforeRegisterNode(nodeLogger: LoggerWithScope): Promise<void>;
+}
+export { ServiceGuardNode };
+//# sourceMappingURL=service-guard-node.d.ts.map

package/dist/node/service-guard/service-guard-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-guard-node.d.ts","sourceRoot":"","sources":["../../../src/node/service-guard/service-guard-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;;;;GAKG;AACH,cAAM,gBAAiB,SAAQ,WAAW;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAElD,OAAO;IAQP,kEAAkE;IAClE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,gBAAgB;cASjD,oBAAoB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBnF;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}