target-supabase-sdk 0.1.9 → 0.2.1

package/dist/task/local-task-registry.d.ts

@@ -1,15 +1,23 @@
-import { BootstrapLocalTasksResult, TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH } from "./task-repo-context";
+import { type BootstrapLocalTasksResult, TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH } from "./task-repo-context";
 export interface BootstrapLocalTasksOptions {
     /** Absolute or cwd-relative path to root config; if omitted, tries default paths under `cwd` */
     rootConfigPath?: string;
     /** Base directory for resolving root config (default `process.cwd()`) */
     cwd?: string;
+    /**
+     * When set with an unchanged config fingerprint, skip full scan if this key is already
+     * registered in {@link RepoManager}.
+     */
+    forTaskTypeKey?: string;
 }
 /**
  * Discover local task packages from config files and register them with {@link RepoManager}.
  *
  * **Never throws** for missing root config — returns `{ status: "not_configured" }`.
  *
+ * Re-scans are skipped when the config fingerprint is unchanged (root config + taskDir mtimes).
+ * Concurrent calls share a single in-flight scan (single-flight).
+ *
  * Host app layout (recommended):
  * ```
  * ./config/task.config.js       → { taskDir: "../tasks" }
@@ -22,6 +30,8 @@ export interface BootstrapLocalTasksOptions {
  * Legacy fallback: `./task.config.js` at project root (`taskDir: "./tasks"`).
  */
 export declare function bootstrapLocalTasks(options?: BootstrapLocalTasksOptions): Promise<BootstrapLocalTasksResult>;
+/** Clear fingerprint cache (tests / hot-reload tooling). */
+export declare function clearBootstrapLocalTasksCache(): void;
 export declare function getRegisteredLocalTaskTypeKeys(): string[];
 export { TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH };
 //# sourceMappingURL=local-task-registry.d.ts.map

package/dist/task/local-task-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-task-registry.d.ts","sourceRoot":"","sources":["../../src/task/local-task-registry.ts"],"names":[],"mappings":"AAWA,OAAO,EACH,yBAAyB,EAGzB,qCAAqC,EAGxC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,0BAA0B;IACvC,gGAAgG;IAChG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAuDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,0BAA+B,GACzC,OAAO,CAAC,yBAAyB,CAAC,CA0FpC;AAED,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CAEzD;AAED,OAAO,EAAE,qCAAqC,EAAE,CAAC"}
+{"version":3,"file":"local-task-registry.d.ts","sourceRoot":"","sources":["../../src/task/local-task-registry.ts"],"names":[],"mappings":"AAWA,OAAO,EACH,KAAK,yBAAyB,EAG9B,qCAAqC,EAGxC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,0BAA0B;IACvC,gGAAgG;IAChG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAyMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,GAAE,0BAA+B,GACzC,OAAO,CAAC,yBAAyB,CAAC,CASpC;AAED,4DAA4D;AAC5D,wBAAgB,6BAA6B,IAAI,IAAI,CAGpD;AAED,wBAAgB,8BAA8B,IAAI,MAAM,EAAE,CAEzD;AAED,OAAO,EAAE,qCAAqC,EAAE,CAAC"}

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

@@ -1,26 +1,34 @@
-import { LoggerWithContext } from "../shared/log/log-manager";
-import { ResultCode, Task } from "./task.interface";
-import { ExecutableTaskFn } from "./task-repo-context";
-export type { TaskFn, TaskRepoContext, TaskRunResult, ExecutableTaskFn, TaskRepoScriptDetails, TaskRepoScriptRecord, TaskRunnerRootConfig, TaskLocalPackageConfig, BootstrapLocalTasksResult, BootstrapLocalTasksStatus, } from "./task-repo-context";
-export { TASK_REPO_SCRIPT_CATEGORY, TASK_RUNNER_CONFIG_DIR, TASK_RUNNER_ROOT_CONFIG_FILENAME, TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH, TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH, TASK_LOCAL_PACKAGE_CONFIG_FILENAME, } from "./task-repo-context";
-import { bootstrapLocalTasks, BootstrapLocalTasksOptions, getRegisteredLocalTaskTypeKeys } from "./local-task-registry";
+import type { LoggerWithScope } from "../shared/log";
+import type { ResultCode, Task } from "./task.interface";
+import type { ExecutableTaskFn } from "./task-repo-context";
+export type { BootstrapLocalTasksResult, BootstrapLocalTasksStatus, ExecutableTaskFn, TaskFn, TaskLocalPackageConfig, TaskRepoContext, TaskRepoScriptDetails, TaskRepoScriptRecord, TaskRunnerRootConfig, TaskRunResult, } from "./task-repo-context";
+export { TASK_LOCAL_PACKAGE_CONFIG_FILENAME, TASK_REPO_SCRIPT_CATEGORY, TASK_RUNNER_CONFIG_DIR, TASK_RUNNER_ROOT_CONFIG_FILENAME, TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH, TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH, } from "./task-repo-context";
+import { type BootstrapLocalTasksOptions, bootstrapLocalTasks, clearBootstrapLocalTasksCache, getRegisteredLocalTaskTypeKeys } from "./local-task-registry";
 import type { BootstrapLocalTasksResult } from "./task-repo-context";
-export type PrepareTaskFailureReason = "MISSING_PARAMS" | "REPO_LOAD_FAILED" | "PARAMS_VALIDATION_FAILED" | "TASK_TYPE_KEY_MISMATCH";
+import { type TaskRepoValidationFailureReason } from "./task-repo-validation";
+export type { TaskRepoValidationFailureReason, ValidateTaskRepoAndParamsInput, ValidateTaskRepoAndParamsResult, } from "./task-repo-validation";
+export { TaskRepoValidation } from "./task-repo-validation";
 export interface PrepareTaskResponse {
     isSuccess: boolean;
     taskFn: ExecutableTaskFn | null;
     code?: ResultCode;
     message?: string;
-    reason?: PrepareTaskFailureReason;
+    reason?: TaskRepoValidationFailureReason;
     /** Pipeline step for log aggregation */
     step?: string;
 }
 export interface PrepareTaskParams {
-    logger: LoggerWithContext;
+    logger: LoggerWithScope;
     task: Task;
+    /**
+     * When false, do not fetch Repo from Supabase during validation.
+     * Should match {@link RegisterTasksOptions.includeRemote} on the worker.
+     */
+    includeRemote?: boolean;
+    bootstrapLocalOptions?: BootstrapLocalTasksOptions;
 }
 export interface RegisterTasksOptions {
-    logger: LoggerWithContext;
+    logger: LoggerWithScope;
     local?: BootstrapLocalTasksOptions;
     /** When `true` (default), union local keys with remote `Repo.value` from Supabase. */
     includeRemote?: boolean;
@@ -31,6 +39,7 @@ export interface RegisterTasksResult {
     remote: {
         values: string[];
     };
+    includeRemote: boolean;
 }
 /**
  * Worker startup: discover local task packages + remote Repo rows, merge into `availableTaskList`.
@@ -44,9 +53,10 @@ export interface RegisterTasksResult {
 declare function registerTasks({ logger, local: localOptions, includeRemote, }: RegisterTasksOptions): Promise<RegisterTasksResult>;
 declare const TaskManager: {
     registerTasks: typeof registerTasks;
-    prepareTask: ({ logger, task }: PrepareTaskParams) => Promise<PrepareTaskResponse>;
+    prepareTask: ({ logger, task, includeRemote, bootstrapLocalOptions, }: PrepareTaskParams) => Promise<PrepareTaskResponse>;
     bootstrapLocalTasks: typeof bootstrapLocalTasks;
     getRegisteredLocalTaskTypeKeys: typeof getRegisteredLocalTaskTypeKeys;
+    clearBootstrapLocalTasksCache: typeof clearBootstrapLocalTasksCache;
 };
 export { TaskManager };
 //# sourceMappingURL=task-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/task/task-manager.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAA0C,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,YAAY,EACR,MAAM,EACN,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,GAC5B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,qCAAqC,EACrC,4CAA4C,EAC5C,kCAAkC,GACrC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EACjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,MAAM,wBAAwB,GAC9B,gBAAgB,GAChB,kBAAkB,GAClB,0BAA0B,GAC1B,wBAAwB,CAAC;AAE/B,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,IAAI,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,yBAAyB,CAAC;IACjC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAChC;AAmCD;;;;;;;;GAQG;AACH,iBAAe,aAAa,CAAC,EACzB,MAAM,EACN,KAAK,EAAE,YAAY,EACnB,aAAoB,GACvB,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA0CrD;AAoJD,QAAA,MAAM,WAAW;;oCA5G4B,iBAAiB,KAAG,OAAO,CAAC,mBAAmB,CAAC;;;CAiH5F,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/task/task-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAU,MAAM,qBAAqB,CAAC;AAEpE,YAAY,EACR,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,MAAM,EACN,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,kCAAkC,EAClC,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,4CAA4C,EAC5C,qCAAqC,GACxC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,6BAA6B,EAC7B,8BAA8B,EACjC,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAsB,KAAK,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAElG,YAAY,EACR,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,GAClC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,+BAA+B,CAAC;IACzC,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,IAAI,CAAC;IACX;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;CACtD;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,0BAA0B,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,yBAAyB,CAAC;IACjC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;CAC1B;AAmCD;;;;;;;;GAQG;AACH,iBAAe,aAAa,CAAC,EACzB,MAAM,EACN,KAAK,EAAE,YAAY,EACnB,aAAoB,GACvB,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA2CrD;AA2HD,QAAA,MAAM,WAAW;;2EAhGd,iBAAiB,KAAG,OAAO,CAAC,mBAAmB,CAAC;;;;CAsGlD,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-node.d.ts","sourceRoot":"","sources":["../../src/task/task-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAkB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAA6B,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAO5F;;;GAGG;AACH,cAAM,QAAS,SAAQ,eAAe;IAClC,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,cAAc,CAAQ;IAE9B,IAAI,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAEzC;;cAMe,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAM5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;YAezE,WAAW;YA6KX,YAAY;YA2BZ,eAAe;CAqDhC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/task/task-post-validated.api.d.ts

@@ -0,0 +1,19 @@
+import { type SupabaseResponse } from "../core.interface";
+import type { Task } from "./task.interface";
+/**
+ * Create a task row with publish-time Repo + params validation.
+ * **Node entry only** — requires local Repo bootstrap and {@link TaskRepoValidation}.
+ *
+ * @see target-supabase-sdk/node
+ */
+export declare const postTaskWithValidation: (payload: {
+    name: string;
+    value: string;
+    tagList: string[];
+    taskStatus: import("./task.interface").TaskStatus.OPEN | import("./task.interface").TaskStatus.TODO;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    traceParentId?: string | null | undefined;
+    params?: unknown;
+}) => SupabaseResponse<Task> | Promise<SupabaseResponse<Task>>;
+//# sourceMappingURL=task-post-validated.api.d.ts.map

package/dist/task/task-post-validated.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-post-validated.api.d.ts","sourceRoot":"","sources":["../../src/task/task-post-validated.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;8DAiCjC,CAAC"}

package/dist/task/task-post.api.d.ts

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import type { SupabaseResponse } from "../core.interface";
+import { type LoggerWithScope } from "../shared/log";
+import { type Task, TaskStatus } from "./task.interface";
+export declare const postTaskSchema: z.ZodObject<{
+    name: z.ZodString;
+    /** Task type key — matches `task.value`, {@link patchClaimTask}, {@link Repo.value}, and local Repo registry. */
+    value: z.ZodString;
+    params: z.ZodUnknown;
+    taskStatus: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<TaskStatus.OPEN>, z.ZodLiteral<TaskStatus.TODO>]>>>;
+    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    extra: z.ZodOptional<z.ZodString>;
+    traceId: z.ZodOptional<z.ZodString>;
+    traceParentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    value: string;
+    tagList: string[];
+    taskStatus: TaskStatus.OPEN | TaskStatus.TODO;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    traceParentId?: string | null | undefined;
+    params?: unknown;
+}, {
+    name: string;
+    value: string;
+    tagList?: string[] | undefined;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    traceParentId?: string | null | undefined;
+    params?: unknown;
+    taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
+}>;
+export type PostTaskPayload = z.infer<typeof postTaskSchema>;
+export type CreateTaskRowInput = PostTaskPayload & {
+    taskTraceId: string;
+};
+/** Shared DB insert for {@link postTask} and {@link postTaskWithValidation}. */
+export declare function createTaskRow({ name, value, params, taskStatus, tagList, extra, taskTraceId, traceParentId }: CreateTaskRowInput, logger: LoggerWithScope): Promise<SupabaseResponse<Task>>;
+/**
+ * Create a task row (scheduler / admin). **Browser and Node** — no Repo or params validation.
+ * Execution-time checks live in {@link TaskManager.prepareTask}.
+ */
+export declare const postTask: (payload: {
+    name: string;
+    value: string;
+    tagList: string[];
+    taskStatus: TaskStatus.OPEN | TaskStatus.TODO;
+    extra?: string | undefined;
+    traceId?: string | undefined;
+    traceParentId?: string | null | undefined;
+    params?: unknown;
+}) => SupabaseResponse<Task> | Promise<SupabaseResponse<Task>>;
+//# sourceMappingURL=task-post.api.d.ts.map

package/dist/task/task-post.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-post.api.d.ts","sourceRoot":"","sources":["../../src/task/task-post.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAgB,KAAK,eAAe,EAAc,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAgB,KAAK,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAWvE,eAAO,MAAM,cAAc;;IAEvB,iHAAiH;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnH,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG;IAC/C,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,gFAAgF;AAChF,wBAAsB,aAAa,CAC/B,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,kBAAkB,EACnG,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAwCjC;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;8DAenB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { Task, TaskStatus } from "./task.interface";
+export type TaskStatusCount = Partial<Record<TaskStatus, number>>;
+/** Count tasks of `taskType` grouped by each requested status. */
+export declare function countTasksByType(tasks: Task[], taskType: string, statuses: TaskStatus[]): TaskStatusCount;
+/** Total tasks of `taskType` whose status is in `statuses`. */
+export declare function summarizeTaskQueue(tasks: Task[], taskType: string, statuses: TaskStatus[]): number;
+//# sourceMappingURL=task-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task-queue.d.ts","sourceRoot":"","sources":["../../src/task/task-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,eAAe,CAOzG;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAElG"}

package/dist/task/task-repo-context.d.ts

@@ -82,6 +82,8 @@ export interface BootstrapLocalTasksResult {
         taskDir: string;
         error: string;
     }[];
+    /** True when scan was skipped due to unchanged config fingerprint */
+    cached?: boolean;
 }
 /** Host app config directory (relative to `cwd`) — recommended for library consumers */
 export declare const TASK_RUNNER_CONFIG_DIR: "config";

package/dist/task/task-repo-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-repo-context.d.ts","sourceRoot":"","sources":["../../src/task/task-repo-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC5B,mBAAmB,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAG,QAAiB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAClC;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACjC,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACnC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,yBAAyB;AACjC,mFAAmF;AACjF,QAAQ;AACV,kDAAkD;GAChD,OAAO;AACT,qGAAqG;GACnG,gBAAgB;AAClB,qCAAqC;GACnC,QAAQ,CAAC;AAEf,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,yBAAyB,CAAC;IAClC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChD;AAED,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAExD,eAAO,MAAM,gCAAgC,EAAG,gBAAyB,CAAC;AAE1E,wDAAwD;AACxD,eAAO,MAAM,qCAAqC,yBAA2E,CAAC;AAE9H,sCAAsC;AACtC,eAAO,MAAM,4CAA4C,kBAAmC,CAAC;AAE7F,kEAAkE;AAClE,eAAO,MAAM,kCAAkC,EAAG,gBAAyB,CAAC"}
+{"version":3,"file":"task-repo-context.d.ts","sourceRoot":"","sources":["../../src/task/task-repo-context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC5B,mBAAmB,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAG,QAAiB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;CAClC;AAED,8FAA8F;AAC9F,MAAM,WAAW,oBAAoB;IACjC,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACnC,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,yBAAyB;AACjC,mFAAmF;AACjF,QAAQ;AACV,kDAAkD;GAChD,OAAO;AACT,qGAAqG;GACnG,gBAAgB;AAClB,qCAAqC;GACnC,QAAQ,CAAC;AAEf,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,yBAAyB,CAAC;IAClC,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7C,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAG,QAAiB,CAAC;AAExD,eAAO,MAAM,gCAAgC,EAAG,gBAAyB,CAAC;AAE1E,wDAAwD;AACxD,eAAO,MAAM,qCAAqC,yBAC0B,CAAC;AAE7E,sCAAsC;AACtC,eAAO,MAAM,4CAA4C,kBAAmC,CAAC;AAE7F,kEAAkE;AAClE,eAAO,MAAM,kCAAkC,EAAG,gBAAyB,CAAC"}

package/dist/task/task-repo-validation.d.ts

@@ -0,0 +1,46 @@
+import { type RepoContextFailureReason } from "../repo/repo-manager";
+import type { LoggerWithScope } from "../shared/log";
+import { type BootstrapLocalTasksOptions } from "./local-task-registry";
+import { ResultCode } from "./task.interface";
+import type { TaskRepoContext } from "./task-repo-context";
+export type TaskRepoValidationFailureReason = "MISSING_PARAMS" | RepoContextFailureReason | "PARAMS_VALIDATION_FAILED" | "TASK_TYPE_KEY_MISMATCH";
+export type ValidateTaskRepoAndParamsInput = {
+    logger: LoggerWithScope;
+    taskTypeKey: string;
+    params: unknown;
+    /**
+     * When true, run {@link bootstrapLocalTasks} before resolve (CLI / Trigger / postTaskWithValidation).
+     * Worker paths should omit — {@link TaskManager.registerTasks} already bootstrapped.
+     */
+    bootstrapLocal?: boolean;
+    bootstrapLocalOptions?: BootstrapLocalTasksOptions;
+    /**
+     * When false, do not fetch Repo from Supabase if the task type is not locally registered.
+     * Default `true`. Align with {@link RegisterTasksOptions.includeRemote}.
+     */
+    includeRemote?: boolean;
+};
+export type ValidateTaskRepoAndParamsFailure = {
+    isValid: false;
+    code: ResultCode;
+    message: string;
+    reason: TaskRepoValidationFailureReason;
+    step: string;
+};
+export type ValidateTaskRepoAndParamsSuccess = {
+    isValid: true;
+    repoContext: TaskRepoContext;
+};
+export type ValidateTaskRepoAndParamsResult = ValidateTaskRepoAndParamsFailure | ValidateTaskRepoAndParamsSuccess;
+/**
+ * Resolve task Repo context and validate `params` via `taskParamsValidator`.
+ *
+ * Repo resolution uses {@link RepoManager.getRepoContext}:
+ * local registry first; when no local entry and `includeRemote`, loads from Supabase.
+ */
+declare function validateTaskRepoAndParams({ logger, taskTypeKey, params, bootstrapLocal, bootstrapLocalOptions, includeRemote, }: ValidateTaskRepoAndParamsInput): Promise<ValidateTaskRepoAndParamsResult>;
+declare const TaskRepoValidation: {
+    validate: typeof validateTaskRepoAndParams;
+};
+export { TaskRepoValidation, validateTaskRepoAndParams };
+//# sourceMappingURL=task-repo-validation.d.ts.map

package/dist/task/task-repo-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-repo-validation.d.ts","sourceRoot":"","sources":["../../src/task/task-repo-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,wBAAwB,EAAe,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,0BAA0B,EAAuB,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,+BAA+B,GACrC,gBAAgB,GAChB,wBAAwB,GACxB,0BAA0B,GAC1B,wBAAwB,CAAC;AAE/B,MAAM,MAAM,8BAA8B,GAAG;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IACnD;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC3C,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,+BAA+B,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC3C,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,eAAe,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG,gCAAgC,GAAG,gCAAgC,CAAC;AA2BlH;;;;;GAKG;AACH,iBAAe,yBAAyB,CAAC,EACrC,MAAM,EACN,WAAW,EACX,MAAM,EACN,cAAsB,EACtB,qBAAqB,EACrB,aAAoB,GACvB,EAAE,8BAA8B,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAgF3E;AAED,QAAA,MAAM,kBAAkB;;CAEvB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/task/task.api.d.ts

@@ -1,6 +1,6 @@
-import { type SupabaseResponse } from "../core.interface";
 import { z } from "zod";
-import { Task, TaskStatus, TaskStatusAction } from "./task.interface";
+import { type SupabaseResponse } from "../core.interface";
+import { type Task, TaskStatusAction } from "./task.interface";
 export declare const patchChangeTaskStatusSchema: z.ZodDiscriminatedUnion<"action", [z.ZodObject<{
     action: z.ZodLiteral<TaskStatusAction.PUBLISH>;
     id: z.ZodString;
@@ -139,33 +139,6 @@ export declare const patchClaimTaskSchema: z.ZodObject<{
     traceId?: string | undefined;
 }>;
 export type PatchClaimTaskPayload = z.infer<typeof patchClaimTaskSchema>;
-export declare const postTaskSchema: z.ZodObject<{
-    name: z.ZodString;
-    /** Task type key — matches `task.value`, {@link patchClaimTask}, {@link Repo.value}, and local Repo registry. */
-    value: z.ZodString;
-    params: z.ZodUnknown;
-    taskStatus: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<TaskStatus.OPEN>, z.ZodLiteral<TaskStatus.TODO>]>>>;
-    tagList: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
-    extra: z.ZodOptional<z.ZodString>;
-    traceId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    value: string;
-    tagList: string[];
-    taskStatus: TaskStatus.OPEN | TaskStatus.TODO;
-    extra?: string | undefined;
-    traceId?: string | undefined;
-    params?: unknown;
-}, {
-    name: string;
-    value: string;
-    tagList?: string[] | undefined;
-    extra?: string | undefined;
-    traceId?: string | undefined;
-    params?: unknown;
-    taskStatus?: TaskStatus.OPEN | TaskStatus.TODO | undefined;
-}>;
-export type PostTaskPayload = z.infer<typeof postTaskSchema>;
 export declare const patchChangeTaskStatus: (payload: {
     id: string;
     action: TaskStatusAction.PUBLISH;
@@ -201,7 +174,7 @@ export declare const patchChangeTaskStatus: (payload: {
     cost: number;
     extra?: string | undefined;
     traceId?: string | undefined;
-}) => SupabaseResponse<Task> | Promise<SupabaseResponse<Task>>;
+}) => SupabaseResponse<unknown> | Promise<SupabaseResponse<unknown>>;
 /** Update progress on a DOING task; only the owning node may write (see `lockOnDoingOwner`). */
 export declare const patchTaskProgress: (payload: {
     id: string;
@@ -212,30 +185,15 @@ export declare const patchTaskProgress: (payload: {
 /**
  * Discover and claim one TODO task for this node.
  *
- * Flow: filter by `availableTaskList` → {@link claimTaskById} (same as `action: CLAIM`).
+ * Flow: oldest TODO in `availableTaskList` (FIFO by `created_at`) → {@link claimTaskById}.
  * Equivalent to `patchChangeTaskStatus({ id, action: CLAIM, nodeId })` when `id` is already known.
  *
  * Returns `data: null` when no TODO task matches.
- * Optimistic lock conflicts return `{ error }` with `code: "OPTIMISTIC_LOCK"` (not thrown).
+ * Optimistic lock conflicts return `{ error, code: OPTIMISTIC_LOCK_ERROR_CODE }` (not thrown).
  */
 export declare const patchClaimTask: (payload: {
     nodeId: string;
     availableTaskList: string[];
     traceId?: string | undefined;
 }) => SupabaseResponse<Task | null> | Promise<SupabaseResponse<Task | null>>;
-/**
- * Create a task row (scheduler / admin).
- *
- * `taskStatus` defaults to **TODO** (worker-claimable). Pass **OPEN** for draft tasks
- * that require {@link patchChangeTaskStatus} `publish` before workers can claim.
- */
-export declare const postTask: (payload: {
-    name: string;
-    value: string;
-    tagList: string[];
-    taskStatus: TaskStatus.OPEN | TaskStatus.TODO;
-    extra?: string | undefined;
-    traceId?: string | undefined;
-    params?: unknown;
-}) => SupabaseResponse<Task> | Promise<SupabaseResponse<Task>>;
 //# sourceMappingURL=task.api.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4B,IAAI,EAAe,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAyD7G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BtC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAQzE,eAAO,MAAM,cAAc;;IAEvB,iHAAiH;;;;;;;;;;;;;;;;;;;;;;;EAOnH,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAgG7D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAiGhC,CAAC;AAIH,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;8DAe5B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;4EAgCzB,CAAC;AAIH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;8DAkCnB,CAAC"}
+{"version":3,"file":"task.api.d.ts","sourceRoot":"","sources":["../../src/task/task.api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI5E,OAAO,EAA4B,KAAK,IAAI,EAAgC,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA0DvH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2BtC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEvF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE/E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAgGzE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAmGhC,CAAC;AAIH,gGAAgG;AAChG,eAAO,MAAM,iBAAiB;;;;;8DAe5B,CAAC;AAIH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;4EA0DzB,CAAC"}

package/dist/task/task.constant.d.ts

@@ -0,0 +1,4 @@
+/** Log topic for task domain (`topic` field on structured logs). */
+export declare const LOG_TOPIC_TASK = "task";
+export declare const CRITICAL_UNKNOWN_TASK_TRACE_ID = "CRITICAL_UNKNOWN_TASK_TRACE_ID";
+//# sourceMappingURL=task.constant.d.ts.map

package/dist/task/task.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.constant.d.ts","sourceRoot":"","sources":["../../src/task/task.constant.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,eAAO,MAAM,cAAc,SAAS,CAAC;AAErC,eAAO,MAAM,8BAA8B,mCAAmC,CAAC"}

package/dist/task/task.interface.d.ts

@@ -1,4 +1,4 @@
-import { Target } from "../core.interface";
+import type { Target } from "../core.interface";
 export declare enum CategoryTask {
     TASK = "task"
 }
@@ -44,6 +44,8 @@ export interface TaskDetails {
     /** [0,100] */
     progress: number;
     nodeId: null | string;
+    /** Task lifecycle correlation id (written at postTask). */
+    traceId?: string;
     result?: {
         cost: number;
         code: ResultCode;

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

@@ -1 +1 @@
-{"version":3,"file":"task.interface.d.ts","sourceRoot":"","sources":["../../src/task/task.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,oBAAY,UAAU;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CACpB;AAED,kGAAkG;AAClG,oBAAY,gBAAgB;IACxB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;CACpB;AAED,oBAAY,UAAU;IAClB,OAAO,OAAO;IAEd,mBAAmB;IACnB,gBAAgB,OAAO;IACvB,cAAc,OAAO;IAErB,kBAAkB;IAClB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,gBAAgB,OAAO;IAEvB,aAAa,OAAO;CACvB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAA;CACJ;AAGD,MAAM,WAAW,QAAS,SAAQ,MAAM;CAEvC"}
+{"version":3,"file":"task.interface.d.ts","sourceRoot":"","sources":["../../src/task/task.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,oBAAY,YAAY;IACpB,IAAI,SAAS;CAChB;AAED,oBAAY,UAAU;IAClB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;CACpB;AAED,kGAAkG;AAClG,oBAAY,gBAAgB;IACxB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;CACpB;AAED,oBAAY,UAAU;IAClB,OAAO,OAAO;IAEd,mBAAmB;IACnB,gBAAgB,OAAO;IACvB,cAAc,OAAO;IAErB,kBAAkB;IAClB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,gBAAgB,OAAO;IAEvB,aAAa,OAAO;CACvB;AAED,MAAM,WAAW,IAAK,SAAQ,MAAM;IAChC,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACL;AAGD,MAAM,WAAW,QAAS,SAAQ,MAAM;CAAG"}

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

@@ -0,0 +1,25 @@
+import type { NodeLoopContext } from "../node/node-runtime.base";
+import type { RegisterTriggerRunnerOptions } from "./trigger.interface";
+export type { RegisterTriggerRunnerOptions, TriggerRunnerContext, TriggerRunnerFn } from "./trigger.interface";
+/** In-process registry and tick loop for {@link TriggerNode}. */
+export declare const TriggerManager: {
+    registerRunner(options: RegisterTriggerRunnerOptions): void;
+    hasRunner(key: string): boolean;
+    unregisterRunner(key: string): boolean;
+    getRunnerKeys(): string[];
+    getRunnersBelowLoopInterval(): Array<{
+        key: string;
+        intervalMs: number;
+    }>;
+    /** Called by TriggerNode during bootstrap — blocks further registerRunner calls. */
+    closeRegistration(): void;
+    /** Re-open registration (tests only). */
+    _resetRegistrationForTests(): void;
+    /**
+     * Remove all runners. Throws if any runner is still executing.
+     * Wait for in-flight ticks to finish before calling in tests.
+     */
+    clearRunners(): void;
+    tick(ctx: NodeLoopContext): Promise<void>;
+};
+//# sourceMappingURL=trigger-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-manager.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AASjE,OAAO,KAAK,EAAE,4BAA4B,EAAyC,MAAM,qBAAqB,CAAC;AAE/G,YAAY,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkF/G,iEAAiE;AACjE,eAAO,MAAM,cAAc;4BACC,4BAA4B,GAAG,IAAI;mBA2B5C,MAAM,GAAG,OAAO;0BAKT,MAAM,GAAG,OAAO;qBAerB,MAAM,EAAE;mCAIM,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAMzE,oFAAoF;yBAC/D,IAAI;IAIzB,yCAAyC;kCACX,IAAI;IAIlC;;;OAGG;oBACa,IAAI;cAUJ,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CA0ClD,CAAC"}

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

@@ -0,0 +1,23 @@
+import { BaseNodeRuntime, type NodeLoopContext } from "../node/node-runtime.base";
+import { type LoggerWithScope, LogLevel } from "../shared/log";
+import type { TriggerNodeOptions } from "./trigger.interface";
+/**
+ * Local interval scheduler node.
+ * Main loop: commands → heartbeat → {@link TriggerManager.tick}.
+ *
+ * Register runners via {@link TriggerManager.registerRunner} before {@link start}.
+ * Does not scan Supabase trigger rows — see `trigger.api.ts` for remote admin APIs.
+ *
+ * Deploy **one** TriggerNode per logical scheduler — multiple processes duplicate runner work.
+ */
+declare class TriggerNode extends BaseNodeRuntime {
+    private readonly requireRunners;
+    constructor(options?: TriggerNodeOptions);
+    protected getLoopIntervalMs(): number;
+    protected loopLoggerMinLevel(): LogLevel;
+    protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
+    protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;
+}
+export type { TriggerNodeOptions } from "./trigger.interface";
+export { TriggerNode };
+//# sourceMappingURL=trigger-node.d.ts.map

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

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