target-supabase-sdk 0.1.9 → 0.2.0

package/dist/node/task-node.js

@@ -0,0 +1,245 @@
+import { logManager, withModule, } from "../shared/log";
+import { scopeForNodeLoop } from "./node-log-scope";
+import { getErrorMessage, toError } from "../shared/utils/error.utils";
+import { TaskManager } from "../task/task-manager";
+import { patchChangeTaskStatus, patchClaimTask } from "../task/task.api";
+import { TaskStatusAction } from "../task/task.interface";
+import { BaseNodeRuntime } from "./node-runtime.base";
+/**
+ * Task worker node: commands → heartbeat → claim & execute tasks.
+ * Built on {@link BaseNodeRuntime}.
+ */
+class TaskNode extends BaseNodeRuntime {
+    _availableTaskList = [];
+    _includeRemote = true;
+    get availableTaskList() {
+        return [...this._availableTaskList];
+    }
+    constructor() {
+        super("taskNode");
+    }
+    async onBeforeRegisterNode(logger) {
+        logger.info("開始註冊任務", { topic: "node" });
+        const { availableTaskList, includeRemote } = await TaskManager.registerTasks({ logger });
+        this._availableTaskList = availableTaskList;
+        this._includeRemote = includeRemote;
+    }
+    async runLoopSteps(ctx, heartbeatOk) {
+        const loopScope = scopeForNodeLoop({
+            module: `${this.runtimeModule}-loop-iteration`,
+            traceId: ctx.loopTraceId,
+            nodeId: ctx.nodeId,
+        });
+        if (!heartbeatOk) {
+            const { logger } = logManager.withScope(loopScope);
+            logger.warn("心跳失敗，本輪跳過任務認領", { topic: "node" });
+            return;
+        }
+        await this.runAsWorker(ctx);
+    }
+    async runAsWorker(ctx) {
+        const { loopTraceId, nodeId } = ctx;
+        const loopScope = scopeForNodeLoop({ module: "runAsWorker", traceId: loopTraceId, nodeId });
+        const { logger } = logManager.withScope(loopScope);
+        const availableTaskList = this.availableTaskList;
+        if (availableTaskList.length === 0) {
+            logger.warn("未配置可認領任務類型，跳過本輪", { topic: "task" });
+            return;
+        }
+        logger.info("向 Supabase 認領任務", {
+            topic: "task",
+            data: { availableTaskList },
+        });
+        const { data: task, error: claimError } = await patchClaimTask({
+            nodeId,
+            availableTaskList: [...availableTaskList],
+            traceId: loopTraceId,
+        });
+        if (claimError) {
+            logger.error("認領任務 API 失敗", {
+                topic: "task",
+                data: {
+                    availableTaskList,
+                    error: claimError.message,
+                },
+            });
+            return;
+        }
+        if (task == null) {
+            logger.info("本輪無匹配的 TODO 任務", {
+                topic: "task",
+                data: { availableTaskList },
+            });
+            return;
+        }
+        logger.info("認領任務成功，準備執行", {
+            topic: "task",
+            data: {
+                taskId: task.id,
+                taskName: task.name,
+                taskTypeKey: task.value,
+                taskStatus: task.details.status,
+            },
+        });
+        const taskTraceId = task.details.traceId ?? loopTraceId;
+        const taskScope = scopeForNodeLoop({
+            module: "prepareTask",
+            traceId: taskTraceId,
+            nodeId,
+            traceParentId: loopTraceId,
+        });
+        const { logger: prepareLogger } = logManager.withScope(taskScope);
+        const prepareResult = await TaskManager.prepareTask({
+            logger: prepareLogger,
+            task,
+            includeRemote: this._includeRemote,
+        });
+        const { isSuccess: isPrepareSuccess, taskFn, code, message, reason, step } = prepareResult;
+        if (!isPrepareSuccess || taskFn == null) {
+            prepareLogger.critical("任務準備失敗，無法繼續執行，中止任務並 RESET 為 OPEN", {
+                topic: "task",
+                data: {
+                    taskId: task.id,
+                    taskTypeKey: task.value,
+                    code,
+                    message,
+                    reason,
+                    step,
+                },
+            });
+            await this.abortTaskRun({
+                logger: prepareLogger,
+                taskId: task.id,
+                nodeId,
+                traceId: taskTraceId,
+            });
+            return;
+        }
+        const { logger: executeLogger } = logManager.withScope(withModule(taskScope, "executeTask"));
+        const onExecuteAbort = async (error) => {
+            logger.critical("任務執行遇到未知錯誤，中止任務並 RESET 為 OPEN", {
+                topic: "task",
+                data: {
+                    taskId: task.id,
+                    taskName: task.name,
+                    taskTypeKey: task.value,
+                    error: getErrorMessage(error),
+                },
+            });
+            await this.abortTaskRun({
+                logger: executeLogger,
+                taskId: task.id,
+                nodeId,
+                traceId: taskTraceId,
+            });
+        };
+        executeLogger.info("開始執行業務邏輯", {
+            topic: "task",
+            data: { taskId: task.id, displayName: taskFn.displayName },
+        });
+        const startTime = Date.now();
+        let result = null;
+        try {
+            result = await taskFn();
+        }
+        catch (error) {
+            await onExecuteAbort(toError(error));
+            return;
+        }
+        if (result == null) {
+            await onExecuteAbort(new Error("任務執行結果為空"));
+            return;
+        }
+        executeLogger.info("任務執行完成", {
+            topic: "task",
+            data: { taskId: task.id, displayName: taskFn.displayName },
+        });
+        const { isSuccess: isTaskSuccess, cost, extra } = result ?? { isSuccess: false, cost: 0, extra: null };
+        if (isTaskSuccess) {
+            await this.finalizeTaskRun("success", {
+                logger: executeLogger,
+                taskId: task.id,
+                taskTypeKey: task.value,
+                nodeId,
+                cost,
+                extra,
+                traceId: taskTraceId,
+            });
+        }
+        else {
+            await this.finalizeTaskRun("failure", {
+                logger: executeLogger,
+                taskId: task.id,
+                taskTypeKey: task.value,
+                nodeId,
+                cost,
+                extra,
+                traceId: taskTraceId,
+            });
+        }
+        const duration = Date.now() - startTime;
+        executeLogger.info("業務邏輯執行完成", {
+            topic: "task",
+            data: { taskId: task.id, durationMs: duration },
+        });
+    }
+    async abortTaskRun(params) {
+        const { logger, taskId, nodeId, traceId, extra } = params;
+        const logData = { taskId, nodeId };
+        const extraValue = typeof extra === "string" ? extra : undefined;
+        const { error } = await patchChangeTaskStatus({
+            id: taskId,
+            action: TaskStatusAction.RESET,
+            nodeId,
+            extra: extraValue,
+            traceId,
+        });
+        if (error) {
+            logger.error(error.message, { topic: "task", data: logData });
+            return false;
+        }
+        logger.info("任務已中止並 RESET 為 OPEN", { topic: "task", data: logData });
+        return true;
+    }
+    async finalizeTaskRun(outcome, params) {
+        const { logger, taskId, nodeId, taskTypeKey, cost, extra, traceId } = params;
+        const outcomePrefix = outcome === "success" ? "任務成功" : "任務失敗";
+        const logData = {
+            taskTypeKey,
+            taskId,
+            nodeId,
+            ...(extra != null && extra !== "" ? { extra } : {}),
+        };
+        const extraValue = typeof extra === "string" ? extra : undefined;
+        const { error: changeTaskStatusError } = outcome === "success"
+            ? await patchChangeTaskStatus({
+                id: taskId,
+                action: TaskStatusAction.FINISH,
+                nodeId,
+                cost,
+                extra: extraValue,
+                traceId,
+            })
+            : await patchChangeTaskStatus({
+                id: taskId,
+                action: TaskStatusAction.RESET,
+                nodeId,
+                extra: extraValue,
+                traceId,
+            });
+        if (changeTaskStatusError) {
+            const upperMessage = `${outcomePrefix}但是更新 TaskStatus 失敗，產生孤兒 Task，請儘快排查問題`;
+            logger.critical(upperMessage, { topic: "task", data: logData });
+            throw new Error(upperMessage);
+        }
+        logger.info("更新 TaskStatus 成功", { topic: "task", data: logData });
+        if (outcome === "success") {
+            logger.success("任務執行結束，業務邏輯成功", { topic: "task", data: logData });
+        }
+        else {
+            logger.warn("任務執行結束，業務邏輯失敗", { topic: "task", data: logData });
+        }
+    }
+}
+export { TaskNode };
+//# sourceMappingURL=task-node.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { type LoggerWithScope } from "../shared/log";
+import { NodeLoopContext } from "./node.interface";
+import { BaseNodeRuntime } from "./node-runtime.base";
+/**
+ * Dedicated trigger scheduler node.
+ * Main loop: commands → heartbeat → evaluate due triggers → postTask.
+ *
+ * Phase 1: run a **single** TriggerNode process per deployment to avoid duplicate fires.
+ */
+declare class TriggerNode extends BaseNodeRuntime {
+    constructor();
+    protected onBeforeRegisterNode(logger: LoggerWithScope): Promise<void>;
+    protected runLoopSteps(ctx: NodeLoopContext, heartbeatOk: boolean): Promise<void>;
+    evaluateTriggers(ctx: NodeLoopContext): Promise<void>;
+    private fireTrigger;
+}
+export { TriggerNode };
+//# sourceMappingURL=trigger-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-node.d.ts","sourceRoot":"","sources":["../../src/node/trigger-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAOjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;GAKG;AACH,cAAM,WAAY,SAAQ,eAAe;;cAKrB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAI5D,YAAY,CAAC,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjF,gBAAgB,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YA6C7C,WAAW;CA4E5B;AAmBD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/node/trigger-node.js

@@ -0,0 +1,150 @@
+import { logManager } from "../shared/log";
+import { scopeForNodeLoop } from "./node-log-scope";
+import { postTask } from "../task/task-post.api";
+import { TaskStatus } from "../task/task.interface";
+import { patchTriggerFired, scanEnabledTriggers } from "../trigger/trigger.api";
+import { buildFireKey, isTriggerDue } from "../trigger/trigger.utils";
+import { BaseNodeRuntime } from "./node-runtime.base";
+/**
+ * Dedicated trigger scheduler node.
+ * Main loop: commands → heartbeat → evaluate due triggers → postTask.
+ *
+ * Phase 1: run a **single** TriggerNode process per deployment to avoid duplicate fires.
+ */
+class TriggerNode extends BaseNodeRuntime {
+    constructor() {
+        super("triggerNode");
+    }
+    async onBeforeRegisterNode(logger) {
+        logger.info("Trigger 節點啟動，跳過任務註冊", { topic: "trigger" });
+    }
+    async runLoopSteps(ctx, heartbeatOk) {
+        const loopScope = scopeForNodeLoop({
+            module: `${this.runtimeModule}-loop-iteration`,
+            traceId: ctx.loopTraceId,
+            nodeId: ctx.nodeId,
+        });
+        if (!heartbeatOk) {
+            const { logger } = logManager.withScope(loopScope);
+            logger.warn("心跳失敗，本輪跳過 Trigger 評估", { topic: "trigger" });
+            return;
+        }
+        await this.evaluateTriggers(ctx);
+    }
+    async evaluateTriggers(ctx) {
+        const { loopTraceId, nodeId } = ctx;
+        const loopScope = scopeForNodeLoop({ module: "evaluateTriggers", traceId: loopTraceId, nodeId });
+        const { logger } = logManager.withScope(loopScope);
+        logger.debug("開始評估 Trigger", { topic: "trigger" });
+        const { data: triggerList = [], error } = await scanEnabledTriggers({ traceId: loopTraceId });
+        if (error) {
+            logger.warn("掃描 Trigger 失敗", {
+                topic: "trigger",
+                data: { error: error.message },
+            });
+            return;
+        }
+        if (triggerList.length === 0) {
+            logger.info("無 ENABLED Trigger", { topic: "trigger" });
+            return;
+        }
+        const now = new Date();
+        let dueCount = 0;
+        let firedCount = 0;
+        for (const trigger of triggerList) {
+            if (!isTriggerDue(trigger, now)) {
+                continue;
+            }
+            dueCount++;
+            const fired = await this.fireTrigger(ctx, trigger, now);
+            if (fired) {
+                firedCount++;
+            }
+        }
+        logger.info("Trigger 評估完成", {
+            topic: "trigger",
+            data: {
+                scanned: triggerList.length,
+                due: dueCount,
+                fired: firedCount,
+            },
+        });
+    }
+    async fireTrigger(ctx, trigger, now) {
+        const { loopTraceId, nodeId } = ctx;
+        const { logger } = logManager.withScope(scopeForNodeLoop({ module: "fireTrigger", traceId: loopTraceId, nodeId }));
+        const fireKey = buildFireKey(trigger, now);
+        const action = trigger.details.action;
+        if (action.kind !== "post_task") {
+            logger.warn("不支援的 Trigger action", {
+                topic: "trigger",
+                data: { triggerId: trigger.id, kind: action.kind },
+            });
+            return false;
+        }
+        logger.info("Trigger 到期，準備 postTask", {
+            topic: "trigger",
+            data: {
+                triggerId: trigger.id,
+                triggerKey: trigger.value,
+                fireKey,
+                taskTypeKey: action.taskTypeKey,
+            },
+        });
+        const taskExtra = `trigger:${trigger.id}:${fireKey}`;
+        const { data: task, error: postError } = await postTask(buildPostTaskPayload(trigger, action, taskExtra, loopTraceId));
+        if (postError) {
+            logger.error("Trigger postTask 失敗", {
+                topic: "trigger",
+                data: {
+                    triggerId: trigger.id,
+                    fireKey,
+                    error: postError.message,
+                },
+            });
+            return false;
+        }
+        const { error: patchError } = await patchTriggerFired({
+            triggerId: trigger.id,
+            fireKey,
+            expectedLastFireKey: trigger.details.lastFireKey ?? null,
+            traceId: loopTraceId,
+        });
+        if (patchError) {
+            logger.warn("Trigger 已 postTask 但更新 lastFireKey 失敗", {
+                topic: "trigger",
+                data: {
+                    triggerId: trigger.id,
+                    taskId: task?.id,
+                    fireKey,
+                    error: patchError.message,
+                },
+            });
+            return false;
+        }
+        logger.success("Trigger 觸發成功", {
+            topic: "trigger",
+            data: {
+                triggerId: trigger.id,
+                triggerKey: trigger.value,
+                fireKey,
+                taskId: task?.id,
+                taskTraceId: task?.details.traceId,
+            },
+        });
+        return true;
+    }
+}
+function buildPostTaskPayload(trigger, action, extra, loopTraceId) {
+    return {
+        name: action.taskName ?? trigger.name,
+        value: action.taskTypeKey,
+        params: action.taskParams,
+        taskStatus: action.taskStatus ?? TaskStatus.TODO,
+        tagList: trigger.tagList ?? [],
+        extra,
+        traceParentId: loopTraceId,
+    };
+}
+export { TriggerNode };
+//# sourceMappingURL=trigger-node.js.map

package/dist/node/trigger-node.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Node.js runtime entry — browser API plus local FS / worker orchestration.
+ *
+ * import { TaskManager, RepoManager, TaskNode } from "target-supabase-sdk/node";
+ */
+export * from "./browser";
+export { TaskManager } from "./task/task-manager";
+export type { PrepareTaskFailureReason, PrepareTaskParams, PrepareTaskResponse, RegisterTasksOptions, RegisterTasksResult, TaskFn, TaskRepoContext, TaskRunResult, ExecutableTaskFn, TaskRepoScriptDetails, TaskRepoScriptRecord, TaskRunnerRootConfig, TaskLocalPackageConfig, BootstrapLocalTasksResult, BootstrapLocalTasksStatus, } from "./task/task-manager";
+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/task-manager";
+export { postTask, postTaskSchema, } from "./task/task-post.api";
+export type { PostTaskPayload } from "./task/task-post.api";
+export { TaskRepoValidation, validateTaskRepoAndParams, } from "./task/task-repo-validation";
+export type { TaskRepoValidationFailureReason, ValidateTaskRepoAndParamsInput, ValidateTaskRepoAndParamsResult, } from "./task/task-repo-validation";
+export { RepoManager } from "./repo/repo-manager";
+export { TaskNode } from "./node/task-node";
+export { TriggerNode } from "./node/trigger-node";
+export { BaseNodeRuntime } from "./node/node-runtime.base";
+export * from "./command/command.interface";
+export * from "./command/command.api";
+export * from "./trigger/trigger.interface";
+export * from "./trigger/trigger.api";
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EACX,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,MAAM,EACN,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,qCAAqC,EACrC,4CAA4C,EAC5C,kCAAkC,GAClC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,QAAQ,EACR,cAAc,GACd,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACX,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,GAC/B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AAEtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

package/dist/node.js

@@ -0,0 +1,19 @@
+/**
+ * Node.js runtime entry — browser API plus local FS / worker orchestration.
+ *
+ * import { TaskManager, RepoManager, TaskNode } from "target-supabase-sdk/node";
+ */
+export * from "./browser";
+export { TaskManager } from "./task/task-manager";
+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/task-manager";
+export { postTask, postTaskSchema, } from "./task/task-post.api";
+export { TaskRepoValidation, validateTaskRepoAndParams, } from "./task/task-repo-validation";
+export { RepoManager } from "./repo/repo-manager";
+export { TaskNode } from "./node/task-node";
+export { TriggerNode } from "./node/trigger-node";
+export { BaseNodeRuntime } from "./node/node-runtime.base";
+export * from "./command/command.interface";
+export * from "./command/command.api";
+export * from "./trigger/trigger.interface";
+export * from "./trigger/trigger.api";
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAkBlD,OAAO,EACN,yBAAyB,EACzB,sBAAsB,EACtB,gCAAgC,EAChC,qCAAqC,EACrC,4CAA4C,EAC5C,kCAAkC,GAClC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,QAAQ,EACR,cAAc,GACd,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC;AAEtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,uBAAuB,CAAC"}

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

@@ -1,28 +1,39 @@
-import { LoggerWithContext } from "../shared/log/log-manager";
+import { LoggerWithScope } from "../shared/log";
 import type { TaskRepoContext } from "../task/task-repo-context";
 import { clearRepoScriptModuleCache } from "./repo.script-loader";
+export type RepoContextFailureReason = "LOCAL_REPO_LOAD_FAILED" | "LOCAL_REPO_NOT_FOUND" | "REMOTE_REPO_NOT_FOUND" | "REMOTE_REPO_LOAD_FAILED";
+export type RepoContextResolvedVia = "local" | "remote";
 export interface GetRepoContextParams {
-    logger: LoggerWithContext;
+    logger: LoggerWithScope;
     /** Task type key (`task.value`) — matches {@link Repo.value} for remote lookup; local registry key */
     taskTypeKey: string;
+    /**
+     * When false, skip Supabase fetch if the task type is not in the local registry.
+     * Default `true`.
+     */
+    includeRemote?: boolean;
 }
 export interface GetRepoContextResult<T extends TaskRepoContext = TaskRepoContext> {
     context: T | null;
     /** Present when `context` is null — import / DB / format failure at repo layer */
     error?: string;
+    failureReason?: RepoContextFailureReason;
+    resolvedVia?: RepoContextResolvedVia;
 }
 /** Register an in-process TaskRepoContext (highest priority — no Supabase fetch). */
 declare function registerLocalRepoContext(taskTypeKey: string, context: TaskRepoContext): void;
 /** Register a local ESM module path; loaded via dynamic import when the task runs. */
 declare function registerLocalModule(taskTypeKey: string, modulePath: string, exportName?: string): void;
 declare function unregisterLocalRepo(taskTypeKey: string): void;
+declare function hasLocalRepo(taskTypeKey: string): boolean;
 declare function getRegisteredLocalTaskTypeKeys(): string[];
 declare function clearRemoteContextCache(): void;
 declare const RepoManager: {
-    getRepoContext: <RepoContext extends TaskRepoContext>({ logger, taskTypeKey, }: GetRepoContextParams) => Promise<GetRepoContextResult<RepoContext>>;
+    getRepoContext: <RepoContext extends TaskRepoContext>({ logger, taskTypeKey, includeRemote, }: GetRepoContextParams) => Promise<GetRepoContextResult<RepoContext>>;
     registerLocalRepoContext: typeof registerLocalRepoContext;
     registerLocalModule: typeof registerLocalModule;
     unregisterLocalRepo: typeof unregisterLocalRepo;
+    hasLocalRepo: typeof hasLocalRepo;
     getRegisteredLocalTaskTypeKeys: typeof getRegisteredLocalTaskTypeKeys;
     clearRemoteContextCache: typeof clearRemoteContextCache;
     clearRepoScriptModuleCache: typeof clearRepoScriptModuleCache;

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

@@ -1 +1 @@
-{"version":3,"file":"repo-manager.d.ts","sourceRoot":"","sources":["../../src/repo/repo-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,2BAA2B,CAAC;AAQvF,OAAO,EACH,0BAA0B,EAG7B,MAAM,sBAAsB,CAAC;AAW9B,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,sGAAsG;IACtG,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IAC7E,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AA8ID,qFAAqF;AACrF,iBAAS,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAKrF;AAED,sFAAsF;AACtF,iBAAS,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAK/F;AAED,iBAAS,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,iBAAS,8BAA8B,IAAI,MAAM,EAAE,CAElD;AAED,iBAAS,uBAAuB,IAAI,IAAI,CAEvC;AAED,QAAA,MAAM,WAAW;qBA/Da,WAAW,SAAS,eAAe,4BAG9D,oBAAoB,KAAG,OAAO,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;;;;;;;CAoEnE,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"repo-manager.d.ts","sourceRoot":"","sources":["../../src/repo/repo-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,2BAA2B,CAAC;AAQvF,OAAO,EACH,0BAA0B,EAG7B,MAAM,sBAAsB,CAAC;AAW9B,MAAM,MAAM,wBAAwB,GAC9B,wBAAwB,GACxB,sBAAsB,GACtB,uBAAuB,GACvB,yBAAyB,CAAC;AAEhC,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,eAAe,CAAC;IACxB,sGAAsG;IACtG,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IAC7E,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,wBAAwB,CAAC;IACzC,WAAW,CAAC,EAAE,sBAAsB,CAAC;CACxC;AAsJD,qFAAqF;AACrF,iBAAS,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAKrF;AAED,sFAAsF;AACtF,iBAAS,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAK/F;AAED,iBAAS,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,iBAAS,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,iBAAS,8BAA8B,IAAI,MAAM,EAAE,CAElD;AAED,iBAAS,uBAAuB,IAAI,IAAI,CAEvC;AAED,QAAA,MAAM,WAAW;qBA3Ea,WAAW,SAAS,eAAe,2CAI9D,oBAAoB,KAAG,OAAO,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;;;;;;;;CAgFnE,CAAC;AAEF,OAAO,EAAE,WAAW,EAAE,CAAC"}