target-supabase-sdk 0.1.8 → 0.2.0

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

@@ -0,0 +1,37 @@
+import { 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" }
+ * ./tasks/my-task/task.config.js
+ * ./tasks/my-task/index.mjs
+ * ```
+ *
+ * `taskDir` / `entry` paths are relative to **their config file's directory** (see config-file-relative-paths skill).
+ *
+ * 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

@@ -0,0 +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;IACb;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAiND;;;;;;;;;;;;;;;;;;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/local-task-registry.js

@@ -0,0 +1,214 @@
+import { readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { RepoManager } from "../repo/repo-manager";
+import { importJsConfigModule, pathExists, resolveFirstExistingPath, resolvePathFromBaseDir, resolvePathFromConfigFile, } from "../shared/utils/config-path.utils";
+import { TASK_LOCAL_PACKAGE_CONFIG_FILENAME, TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH, TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH, } from "./task-repo-context";
+const EMPTY_RESULT = {
+    status: "not_configured",
+    registered: [],
+    skipped: [],
+    errors: [],
+};
+let bootstrapCache = { fingerprint: null, lastResult: null };
+let bootstrapInFlight = null;
+function parseRootConfig(raw, configPath) {
+    if (raw == null || typeof raw !== "object") {
+        throw new Error(`Root config must export an object: ${configPath}`);
+    }
+    const record = raw;
+    const taskDir = record.taskDir;
+    if (typeof taskDir !== "string" || taskDir.trim() === "") {
+        throw new Error(`Root config.taskDir must be a non-empty string: ${configPath}`);
+    }
+    return { taskDir: taskDir.trim() };
+}
+function parseTaskPackageConfig(raw, configPath) {
+    if (raw == null || typeof raw !== "object") {
+        throw new Error(`Task config must export an object: ${configPath}`);
+    }
+    const record = raw;
+    const taskTypeKey = record.taskTypeKey;
+    const entry = record.entry;
+    if (typeof taskTypeKey !== "string" || taskTypeKey.trim() === "") {
+        throw new Error(`taskTypeKey must be a non-empty string: ${configPath}`);
+    }
+    if (typeof entry !== "string" || entry.trim() === "") {
+        throw new Error(`entry must be a non-empty string: ${configPath}`);
+    }
+    return {
+        taskTypeKey: taskTypeKey.trim(),
+        entry: entry.trim(),
+        exportName: typeof record.exportName === "string" ? record.exportName : undefined,
+        displayName: typeof record.displayName === "string" ? record.displayName : undefined,
+        enabled: record.enabled === false ? false : true,
+    };
+}
+function finalizeStatus(result) {
+    if (result.errors.length > 0 && result.registered.length === 0) {
+        return "failed";
+    }
+    if (result.registered.length === 0) {
+        return "empty";
+    }
+    return "loaded";
+}
+async function computeConfigFingerprint(rootConfigPath, tasksRoot) {
+    const rootStat = await stat(rootConfigPath);
+    const tasksRootStat = await stat(tasksRoot);
+    const entries = await readdir(tasksRoot, { withFileTypes: true });
+    const configMtims = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const configPath = join(tasksRoot, entry.name, TASK_LOCAL_PACKAGE_CONFIG_FILENAME);
+        if (await pathExists(configPath)) {
+            const configStat = await stat(configPath);
+            configMtims.push(configStat.mtimeMs);
+        }
+    }
+    configMtims.sort((a, b) => a - b);
+    return `${rootConfigPath}:${rootStat.mtimeMs}:${tasksRoot}:${tasksRootStat.mtimeMs}:${configMtims.join(",")}`;
+}
+function canUseCachedBootstrap(fingerprint, forTaskTypeKey) {
+    if (bootstrapCache.fingerprint !== fingerprint || bootstrapCache.lastResult == null) {
+        return null;
+    }
+    if (forTaskTypeKey != null && forTaskTypeKey !== "") {
+        if (!RepoManager.hasLocalRepo(forTaskTypeKey)) {
+            return null;
+        }
+    }
+    return { ...bootstrapCache.lastResult, cached: true };
+}
+async function runBootstrapScan(options) {
+    const cwd = options.cwd ?? process.cwd();
+    const rootConfigPath = await resolveFirstExistingPath(cwd, {
+        explicitPath: options.rootConfigPath,
+        candidatePaths: [
+            TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH,
+            TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH,
+        ],
+    });
+    if (rootConfigPath == null) {
+        const result = {
+            ...EMPTY_RESULT,
+            message: `No root config (tried ${TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH}, ${TASK_RUNNER_ROOT_CONFIG_LEGACY_RELATIVE_PATH})`,
+        };
+        bootstrapCache = { fingerprint: null, lastResult: result };
+        return result;
+    }
+    const result = {
+        registered: [],
+        skipped: [],
+        errors: [],
+    };
+    try {
+        const rootRaw = await importJsConfigModule(rootConfigPath);
+        const { taskDir } = parseRootConfig(rootRaw, rootConfigPath);
+        const tasksRoot = resolvePathFromConfigFile(rootConfigPath, taskDir);
+        if (!(await pathExists(tasksRoot))) {
+            const failed = {
+                status: "failed",
+                message: `taskDir does not exist: ${tasksRoot}`,
+                ...result,
+            };
+            bootstrapCache = { fingerprint: null, lastResult: failed };
+            return failed;
+        }
+        const fingerprint = await computeConfigFingerprint(rootConfigPath, tasksRoot);
+        const cached = canUseCachedBootstrap(fingerprint, options.forTaskTypeKey);
+        if (cached != null) {
+            return cached;
+        }
+        const entries = await readdir(tasksRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory()) {
+                continue;
+            }
+            const taskPackageDir = join(tasksRoot, entry.name);
+            const taskConfigPath = join(taskPackageDir, TASK_LOCAL_PACKAGE_CONFIG_FILENAME);
+            if (!(await pathExists(taskConfigPath))) {
+                result.skipped.push({ taskDir: taskPackageDir, reason: "missing task.config.js" });
+                continue;
+            }
+            try {
+                const taskRaw = await importJsConfigModule(taskConfigPath);
+                const taskConfig = parseTaskPackageConfig(taskRaw, taskConfigPath);
+                if (taskConfig.enabled === false) {
+                    result.skipped.push({ taskDir: taskPackageDir, reason: "disabled in task.config.js" });
+                    continue;
+                }
+                const entryPath = resolvePathFromBaseDir(taskPackageDir, taskConfig.entry);
+                if (!(await pathExists(entryPath))) {
+                    throw new Error(`entry module not found: ${entryPath}`);
+                }
+                RepoManager.registerLocalModule(taskConfig.taskTypeKey, entryPath, taskConfig.exportName);
+                result.registered.push(taskConfig.taskTypeKey);
+            }
+            catch (error) {
+                result.errors.push({
+                    taskDir: taskPackageDir,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        const status = finalizeStatus(result);
+        const finalResult = {
+            status,
+            message: status === "empty"
+                ? `Root config loaded but no tasks registered under ${tasksRoot}`
+                : undefined,
+            ...result,
+        };
+        bootstrapCache = { fingerprint, lastResult: finalResult };
+        return finalResult;
+    }
+    catch (error) {
+        const failed = {
+            status: "failed",
+            message: error instanceof Error ? error.message : String(error),
+            ...result,
+        };
+        bootstrapCache = { fingerprint: null, lastResult: failed };
+        return failed;
+    }
+}
+/**
+ * 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" }
+ * ./tasks/my-task/task.config.js
+ * ./tasks/my-task/index.mjs
+ * ```
+ *
+ * `taskDir` / `entry` paths are relative to **their config file's directory** (see config-file-relative-paths skill).
+ *
+ * Legacy fallback: `./task.config.js` at project root (`taskDir: "./tasks"`).
+ */
+export async function bootstrapLocalTasks(options = {}) {
+    if (bootstrapInFlight != null) {
+        return bootstrapInFlight;
+    }
+    bootstrapInFlight = runBootstrapScan(options).finally(() => {
+        bootstrapInFlight = null;
+    });
+    return bootstrapInFlight;
+}
+/** Clear fingerprint cache (tests / hot-reload tooling). */
+export function clearBootstrapLocalTasksCache() {
+    bootstrapCache = { fingerprint: null, lastResult: null };
+    bootstrapInFlight = null;
+}
+export function getRegisteredLocalTaskTypeKeys() {
+    return RepoManager.getRegisteredLocalTaskTypeKeys();
+}
+export { TASK_RUNNER_ROOT_CONFIG_RELATIVE_PATH };
+//# sourceMappingURL=local-task-registry.js.map

package/dist/task/local-task-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-task-registry.js","sourceRoot":"","sources":["../../src/task/local-task-registry.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,64 @@
+import { LoggerWithScope } from "../shared/log";
+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, clearBootstrapLocalTasksCache, getRegisteredLocalTaskTypeKeys } from "./local-task-registry";
+import type { BootstrapLocalTasksResult } from "./task-repo-context";
+import { type TaskRepoValidationFailureReason } from "./task-repo-validation";
+/** @deprecated use {@link TaskRepoValidationFailureReason} */
+export type PrepareTaskFailureReason = TaskRepoValidationFailureReason;
+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;
+    /** Pipeline step for log aggregation */
+    step?: string;
+}
+export interface PrepareTaskParams {
+    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: LoggerWithScope;
+    local?: BootstrapLocalTasksOptions;
+    /** When `true` (default), union local keys with remote `Repo.value` from Supabase. */
+    includeRemote?: boolean;
+}
+export interface RegisterTasksResult {
+    availableTaskList: string[];
+    local: BootstrapLocalTasksResult;
+    remote: {
+        values: string[];
+    };
+    includeRemote: boolean;
+}
+/**
+ * Worker startup: discover local task packages + remote Repo rows, merge into `availableTaskList`.
+ *
+ * - Local: {@link bootstrapLocalTasks} → registers modules in {@link RepoManager}
+ * - Remote: {@link getScanRemoteRepoValues} with {@link TASK_REPO_USAGE}
+ * - Merge: union of both; execution still prefers local registry in {@link RepoManager.getRepoContext}
+ *
+ * @throws When merged list is empty (no task types to claim).
+ */
+declare function registerTasks({ logger, local: localOptions, includeRemote, }: RegisterTasksOptions): Promise<RegisterTasksResult>;
+declare const TaskManager: {
+    registerTasks: typeof registerTasks;
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.d.ts","sourceRoot":"","sources":["../../src/task/task-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAyB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,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,6BAA6B,EAC7B,8BAA8B,EACjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAsB,KAAK,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAElG,8DAA8D;AAC9D,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEvE,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,wBAAwB,CAAC;IAClC,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-manager.js

@@ -0,0 +1,196 @@
+import { getScanRemoteRepoValues } from "../repo/repo.api";
+import { TASK_REPO_USAGE } from "../repo/repo.interface";
+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, clearBootstrapLocalTasksCache, getRegisteredLocalTaskTypeKeys, } from "./local-task-registry";
+import { TaskRepoValidation } from "./task-repo-validation";
+export { TaskRepoValidation } from "./task-repo-validation";
+function logLocalBootstrap(logger, bootstrap) {
+    switch (bootstrap.status) {
+        case "not_configured":
+            logger.info("未找到本地任務配置，跳過本地註冊", {
+                topic: "task",
+                data: { message: bootstrap.message },
+            });
+            break;
+        case "failed":
+            logger.warn("本地任務註冊失敗", {
+                topic: "task",
+                data: { message: bootstrap.message, errors: bootstrap.errors },
+            });
+            break;
+        case "empty":
+            logger.info("本地任務掃描完成，無已註冊任務", {
+                topic: "task",
+                data: { message: bootstrap.message, skipped: bootstrap.skipped },
+            });
+            break;
+        case "loaded":
+            logger.info("本地任務註冊完成", {
+                topic: "task",
+                data: {
+                    registered: bootstrap.registered,
+                    skipped: bootstrap.skipped,
+                    errors: bootstrap.errors,
+                },
+            });
+            break;
+    }
+}
+/**
+ * Worker startup: discover local task packages + remote Repo rows, merge into `availableTaskList`.
+ *
+ * - Local: {@link bootstrapLocalTasks} → registers modules in {@link RepoManager}
+ * - Remote: {@link getScanRemoteRepoValues} with {@link TASK_REPO_USAGE}
+ * - Merge: union of both; execution still prefers local registry in {@link RepoManager.getRepoContext}
+ *
+ * @throws When merged list is empty (no task types to claim).
+ */
+async function registerTasks({ logger, local: localOptions, includeRemote = true, }) {
+    logger.info("開始註冊任務（本地 + 遠程）", { topic: "task" });
+    const local = await bootstrapLocalTasks(localOptions ?? {});
+    logLocalBootstrap(logger, local);
+    let remoteValues = [];
+    if (includeRemote) {
+        logger.info("查詢遠程 Repo 列表", {
+            topic: "task",
+            data: { usage: TASK_REPO_USAGE },
+        });
+        const { data, error: remoteError } = await getScanRemoteRepoValues({ usage: TASK_REPO_USAGE });
+        if (remoteError) {
+            throw new Error(remoteError.message);
+        }
+        remoteValues = data ?? [];
+        logger.info("遠程 Repo 查詢完成", {
+            topic: "task",
+            data: { count: remoteValues.length, values: remoteValues },
+        });
+    }
+    const availableTaskList = [...new Set([...local.registered, ...remoteValues])];
+    if (availableTaskList.length === 0) {
+        throw new Error("[registerTasks] 任務註冊失敗：本地與遠程均無可用任務類型");
+    }
+    logger.success("任務註冊完成", {
+        topic: "task",
+        data: {
+            availableTaskList,
+            localRegistered: local.registered,
+            remoteValues,
+        },
+    });
+    return {
+        availableTaskList,
+        local,
+        remote: { values: remoteValues },
+        includeRemote,
+    };
+}
+/** 将 taskFn 与 params 闭包绑定，供 TaskNode 无参调用 `await taskFn()` */
+function bindTaskFn(taskFn, taskParams) {
+    const run = async () => taskFn(taskParams);
+    return Object.assign(run, {
+        displayName: taskFn.displayName,
+        taskTypeKey: taskFn.taskTypeKey,
+    });
+}
+/**
+ * 將 Supabase 認領到的 Task 解析為可執行的 `ExecutableTaskFn`。
+ *
+ * 流程：
+ * 1. 從 task.details 取出 `params`；`task.value` 作為 taskTypeKey（同 {@link Repo.value}）
+ * 2. {@link TaskRepoValidation.validate} — 本地註冊優先；未命中時可選遠端（`includeRemote`）
+ *    Worker 在 registry 未命中時會補掃本地（`local_bootstrap_on_miss`）
+ * 3. bindTaskFn，返回閉包後的無參執行函數
+ *
+ * 失敗時返回 `{ isSuccess: false, code, message, reason, step }`（不 throw）。
+ */
+const prepareTask = async ({ logger, task, includeRemote = true, bootstrapLocalOptions, }) => {
+    const fail = (params) => {
+        logger.warn(params.message, {
+            topic: "task",
+            data: {
+                taskId: task.id,
+                taskTypeKey: task.value,
+                reason: params.reason,
+                step: params.step,
+            },
+        });
+        return {
+            isSuccess: false,
+            taskFn: null,
+            code: params.code,
+            message: params.message,
+            reason: params.reason,
+            step: params.step,
+        };
+    };
+    const { id: taskId, name: taskName, value: taskTypeKey, details } = task;
+    logger.info(`開始準備任務 ${taskName}-${taskTypeKey}`, {
+        topic: "task",
+        data: { taskId, taskName, taskTypeKey },
+    });
+    const { params: taskParams } = details;
+    if (!getRegisteredLocalTaskTypeKeys().includes(taskTypeKey)) {
+        const bootstrap = await bootstrapLocalTasks({
+            ...bootstrapLocalOptions,
+            forTaskTypeKey: taskTypeKey,
+        });
+        logger.debug("本地 registry 未命中，補掃本地任務", {
+            topic: "task",
+            data: {
+                taskId,
+                taskTypeKey,
+                step: "local_bootstrap_on_miss",
+                status: bootstrap.status,
+                registered: bootstrap.registered,
+                cached: bootstrap.cached ?? false,
+                message: bootstrap.message,
+            },
+        });
+    }
+    const validation = await TaskRepoValidation.validate({
+        logger,
+        taskTypeKey,
+        params: taskParams,
+        includeRemote,
+    });
+    if (!validation.isValid) {
+        return fail({
+            reason: validation.reason,
+            code: validation.code,
+            message: validation.message,
+            step: validation.step,
+        });
+    }
+    const { repoContext } = validation;
+    logger.info("Repo 上下文加載成功", {
+        topic: "task",
+        data: {
+            taskTypeKey,
+            taskFnDisplayName: repoContext.taskFn.displayName,
+            step: "repo_load",
+        },
+    });
+    const boundTaskFn = bindTaskFn(repoContext.taskFn, taskParams);
+    logger.success("任務準備完成", {
+        topic: "task",
+        data: {
+            taskId,
+            taskTypeKey,
+            displayName: boundTaskFn.displayName,
+            step: "bind",
+        },
+    });
+    return {
+        isSuccess: true,
+        taskFn: boundTaskFn,
+    };
+};
+const TaskManager = {
+    registerTasks,
+    prepareTask,
+    bootstrapLocalTasks,
+    getRegisteredLocalTaskTypeKeys,
+    clearBootstrapLocalTasksCache,
+};
+export { TaskManager };
+//# sourceMappingURL=task-manager.js.map

package/dist/task/task-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.js","sourceRoot":"","sources":["../../src/task/task-manager.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,49 @@
+import { type SupabaseResponse } from "../core.interface";
+import { z } from "zod";
+import { 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>;
+/**
+ * Create a task row (scheduler / admin). **Node entry only** — requires local Repo bootstrap.
+ *
+ * @see target-supabase-sdk/node
+ */
+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":"AACA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAA4B,IAAI,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAY9E,eAAO,MAAM,cAAc;;IAE1B,iHAAiH;;;;;;;;;;;;;;;;;;;;;;;;;;EAQhH,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;8DAgFnB,CAAC"}