target-supabase-sdk 0.1.8 → 0.2.0

package/dist/shared/log/log-manager.js

@@ -0,0 +1,237 @@
+import { isDevEnvironment } from "../../core.utils";
+import { generateUniqueId } from "../utils/id.utils";
+import { applyScopePatch, formatScopeLabels, resolveLogData, } from "./log-scope";
+/**
+ * Log severity and semantics (low → high). `minLevel` filters by {@link LOG_LEVEL_RANK}.
+ *
+ * | Level    | Rank | When to use |
+ * |----------|------|-------------|
+ * | DEBUG    | 0    | Diagnostic detail for dev/troubleshooting; noisy, safe to drop in prod. |
+ * | INFO     | 1    | Normal operational flow (startup, polling, state transitions). |
+ * | SUCCESS  | 2    | Positive milestone within a flow (not a separate severity axis — same band as INFO). |
+ * | WARN     | 3    | Recoverable anomaly or degradation; work continues but worth watching. |
+ * | ERROR    | 4    | A concrete operation failed (API, task step, I/O); investigate and retry/fix locally. |
+ * | CRITICAL | 5    | Invariant violated — design flaw, data-integrity risk, or business rule broken; escalate and fix urgently. |
+ */
+var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "DEBUG";
+    LogLevel["INFO"] = "INFO";
+    LogLevel["SUCCESS"] = "SUCCESS";
+    LogLevel["WARN"] = "WARN";
+    LogLevel["ERROR"] = "ERROR";
+    LogLevel["CRITICAL"] = "CRITICAL";
+})(LogLevel || (LogLevel = {}));
+const LOG_LEVEL_RANK = {
+    [LogLevel.DEBUG]: 0,
+    [LogLevel.INFO]: 1,
+    [LogLevel.SUCCESS]: 2,
+    [LogLevel.WARN]: 3,
+    [LogLevel.ERROR]: 4,
+    [LogLevel.CRITICAL]: 5,
+};
+const DEFAULT_OPTIONS = {
+    defaultTopic: null,
+    formatTimestamp: true,
+    formatEmoji: true,
+    formatPrefix: "",
+    maxHistoryLength: 4096,
+    minLevel: isDevEnvironment() ? LogLevel.DEBUG : LogLevel.INFO,
+};
+function mergeLogOptions(options) {
+    return { ...DEFAULT_OPTIONS, ...options };
+}
+function formatDataValue(value) {
+    if (value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function validateLogScope(logScope) {
+    const missing = [];
+    if (!logScope.module?.trim()) {
+        missing.push("module");
+    }
+    if (!logScope.traceId?.trim()) {
+        missing.push("traceId");
+    }
+    if (logScope.traceParentId !== null && typeof logScope.traceParentId !== "string") {
+        missing.push("traceParentId");
+    }
+    if (missing.length > 0) {
+        console.warn(`[LogManager] LogScope missing or invalid: ${missing.join(", ")}`, logScope);
+    }
+}
+class LogManager {
+    static instance;
+    options;
+    history = [];
+    levelEmojis = {
+        [LogLevel.DEBUG]: "🔍",
+        [LogLevel.INFO]: "ℹ️",
+        [LogLevel.SUCCESS]: "✅",
+        [LogLevel.WARN]: "⚠️",
+        [LogLevel.ERROR]: "❌",
+        [LogLevel.CRITICAL]: "💀",
+    };
+    constructor(options) {
+        this.options = mergeLogOptions(options);
+    }
+    static getInstance(options) {
+        if (!LogManager.instance) {
+            LogManager.instance = new LogManager(options);
+        }
+        else if (options != null && Object.keys(options).length > 0) {
+            console.warn("[LogManager] getInstance(options) ignored — singleton already created. Use setOptions() instead.");
+        }
+        return LogManager.instance;
+    }
+    setOptions(options) {
+        this.options = mergeLogOptions({ ...this.options, ...options });
+    }
+    getHistory() {
+        return [...this.history];
+    }
+    clearHistory() {
+        this.history = [];
+    }
+    getMinLevel() {
+        return this.options.minLevel ?? DEFAULT_OPTIONS.minLevel ?? LogLevel.INFO;
+    }
+    shouldLog(level) {
+        return LOG_LEVEL_RANK[level] >= LOG_LEVEL_RANK[this.getMinLevel()];
+    }
+    createLogEntry(payload) {
+        const { level, message, topic, extra, data, module, traceId, traceParentId, labels } = payload;
+        return {
+            timestamp: Date.now(),
+            level,
+            message,
+            topic: topic === undefined ? this.options.defaultTopic : topic,
+            module,
+            traceId,
+            traceParentId,
+            labels,
+            extra,
+            data,
+        };
+    }
+    formatLevelTag(entry) {
+        const emoji = this.options.formatEmoji ? `${this.levelEmojis[entry.level]} ` : "";
+        if (entry.level === LogLevel.CRITICAL) {
+            return `[${emoji}*** ${entry.level} ***]`;
+        }
+        return `[${emoji}${entry.level}]`;
+    }
+    formatLog(entry) {
+        const parts = [];
+        if (this.options.formatTimestamp) {
+            parts.push(`[${new Date(entry.timestamp).toISOString()}]`);
+        }
+        parts.push(this.formatLevelTag(entry));
+        parts.push(`traceId=${entry.traceId} parent=${entry.traceParentId ?? "null"} labels=${formatScopeLabels(entry.labels)} module=${entry.module} topic=${entry.topic ?? "--"}`);
+        if (this.options.formatPrefix) {
+            parts.push(`prefix=${this.options.formatPrefix}`);
+        }
+        const message = entry.level === LogLevel.CRITICAL ? `>>> ${entry.message} <<<` : entry.message;
+        parts.push(`| ${message}`);
+        if (entry.extra) {
+            parts.push(`| extra=${entry.extra}`);
+        }
+        const dataText = formatDataValue(entry.data);
+        if (dataText) {
+            parts.push(`| data=${dataText}`);
+        }
+        return parts.join(" ");
+    }
+    emitLog(entry, formatted) {
+        switch (entry.level) {
+            case LogLevel.WARN:
+                console.warn(formatted);
+                break;
+            case LogLevel.ERROR:
+            case LogLevel.CRITICAL:
+                console.error(formatted);
+                break;
+            default:
+                console.log(formatted);
+        }
+    }
+    log(level, message, logScope, restParams) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        validateLogScope(logScope);
+        const { topic, extra } = restParams ?? {};
+        const data = resolveLogData(restParams);
+        const entry = this.createLogEntry({
+            level,
+            message,
+            topic,
+            extra,
+            data,
+            ...logScope,
+        });
+        this.history.push(entry);
+        if (this.history.length > this.options.maxHistoryLength) {
+            this.history.shift();
+        }
+        const formatted = this.formatLog(entry);
+        this.emitLog(entry, formatted);
+        this.options.onLog?.(entry);
+    }
+    generateTraceId() {
+        return generateUniqueId();
+    }
+    debug(message, logScope, restParams) {
+        this.log(LogLevel.DEBUG, message, logScope, restParams);
+    }
+    info(message, logScope, restParams) {
+        this.log(LogLevel.INFO, message, logScope, restParams);
+    }
+    success(message, logScope, restParams) {
+        this.log(LogLevel.SUCCESS, message, logScope, restParams);
+    }
+    warn(message, logScope, restParams) {
+        this.log(LogLevel.WARN, message, logScope, restParams);
+    }
+    error(message, logScope, restParams) {
+        this.log(LogLevel.ERROR, message, logScope, restParams);
+    }
+    critical(message, logScope, restParams) {
+        this.log(LogLevel.CRITICAL, message, logScope, restParams);
+    }
+    withScope(scope) {
+        const boundScope = { ...scope, labels: scope.labels ? { ...scope.labels } : undefined };
+        const logger = {
+            debug: (message, restParams) => this.debug(message, boundScope, restParams),
+            info: (message, restParams) => this.info(message, boundScope, restParams),
+            success: (message, restParams) => this.success(message, boundScope, restParams),
+            warn: (message, restParams) => this.warn(message, boundScope, restParams),
+            error: (message, restParams) => this.error(message, boundScope, restParams),
+            critical: (message, restParams) => this.critical(message, boundScope, restParams),
+            resetScope: (fields) => {
+                const next = applyScopePatch(boundScope, fields);
+                boundScope.module = next.module;
+                boundScope.traceId = next.traceId;
+                boundScope.traceParentId = next.traceParentId;
+                boundScope.labels = next.labels;
+            },
+            resetContext: (fields) => {
+                logger.resetScope(fields);
+            },
+        };
+        return { logger, scope: boundScope };
+    }
+}
+export const logManager = LogManager.getInstance();
+export { LogManager, LogLevel };
+//# sourceMappingURL=log-manager.js.map

package/dist/shared/log/log-manager.js.map

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

package/dist/shared/log/log-scope.d.ts

@@ -0,0 +1,49 @@
+/** Logger-bound scope: module + trace chain + optional labels. */
+export interface LogScope {
+    module: string;
+    traceId: string;
+    traceParentId: string | null;
+    labels?: Readonly<Record<string, string>>;
+}
+/** Partial update for {@link LogScope} / {@link applyScopePatch}. */
+export type LogScopePatch = Partial<Omit<LogScope, "labels">> & {
+    labels?: Record<string, string>;
+};
+export type LogScopeInput = LogScopePatch & Pick<LogScope, "module">;
+interface NormalizeScopeOptions {
+    /** When true and traceId is missing, generate a new id. */
+    generateTraceId?: boolean;
+}
+/** Coerce partial input into a {@link LogScope}. */
+export declare function normalizeScope(input: LogScopeInput, options?: NormalizeScopeOptions): LogScope;
+/** Input for {@link createRootScope}. */
+export type CreateRootScopeInput = {
+    module: string;
+    traceId?: string;
+    labels?: Record<string, string>;
+    traceParentId?: string | null;
+};
+/** Root scope: traceParentId defaults to null. */
+export declare function createRootScope(input: CreateRootScopeInput): LogScope;
+/** Input for {@link createChildScope}. */
+export type CreateChildScopeInput = {
+    module: string;
+    parent: LogScope;
+    traceId?: string;
+    traceParentId?: string | null;
+    labels?: Record<string, string>;
+};
+/** Child scope: parent link defaults to parent.traceId; labels merge with parent. */
+export declare function createChildScope(input: CreateChildScopeInput): LogScope;
+/** Same trace chain, different module (e.g. prepareTask vs executeTask). */
+export declare function withModule(scope: LogScope, module: string): LogScope;
+/** Merge patch into scope (labels deep-merge). */
+export declare function applyScopePatch(scope: LogScope, patch: LogScopePatch): LogScope;
+export declare function formatScopeLabels(labels?: Readonly<Record<string, string>>): string;
+/** Prefer `data`; fall back to deprecated `context` on log rest params. */
+export declare function resolveLogData(rest?: {
+    data?: unknown;
+    context?: unknown;
+}): unknown | undefined;
+export {};
+//# sourceMappingURL=log-scope.d.ts.map

package/dist/shared/log/log-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-scope.d.ts","sourceRoot":"","sources":["../../../src/shared/log/log-scope.ts"],"names":[],"mappings":"AAEA,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7C;AAED,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAErE,UAAU,qBAAqB;IAC3B,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAUD,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,QAAQ,CAa9F;AAED,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,QAAQ,CAUrE;AAED,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,QAAQ,CAWvE;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEpE;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ,CAO/E;AACD,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAOnF;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,GAAG,SAAS,CAQhG"}

package/dist/shared/log/log-scope.js

@@ -0,0 +1,70 @@
+import { generateUniqueId } from "../utils/id.utils";
+function mergeLabels(base, patch) {
+    const merged = { ...base, ...patch };
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+/** Coerce partial input into a {@link LogScope}. */
+export function normalizeScope(input, options) {
+    const generateTraceId = options?.generateTraceId ?? false;
+    const traceId = input.traceId?.trim() || (generateTraceId ? generateUniqueId() : "");
+    if (!traceId) {
+        throw new Error("[LogScope] traceId is required (or enable generateTraceId)");
+    }
+    return {
+        module: input.module,
+        traceId,
+        traceParentId: input.traceParentId ?? null,
+        labels: mergeLabels(undefined, input.labels),
+    };
+}
+/** Root scope: traceParentId defaults to null. */
+export function createRootScope(input) {
+    return normalizeScope({
+        module: input.module,
+        traceId: input.traceId,
+        traceParentId: input.traceParentId ?? null,
+        labels: input.labels,
+    }, { generateTraceId: true });
+}
+/** Child scope: parent link defaults to parent.traceId; labels merge with parent. */
+export function createChildScope(input) {
+    const { module, parent, traceId, traceParentId, labels } = input;
+    return normalizeScope({
+        module,
+        traceId,
+        traceParentId: traceParentId ?? parent.traceId,
+        labels: mergeLabels(parent.labels, labels),
+    }, { generateTraceId: true });
+}
+/** Same trace chain, different module (e.g. prepareTask vs executeTask). */
+export function withModule(scope, module) {
+    return { ...scope, module };
+}
+/** Merge patch into scope (labels deep-merge). */
+export function applyScopePatch(scope, patch) {
+    return normalizeScope({
+        module: patch.module ?? scope.module,
+        traceId: patch.traceId ?? scope.traceId,
+        traceParentId: patch.traceParentId !== undefined ? patch.traceParentId : scope.traceParentId,
+        labels: mergeLabels(scope.labels, patch.labels),
+    });
+}
+export function formatScopeLabels(labels) {
+    if (labels == null || Object.keys(labels).length === 0) {
+        return "--";
+    }
+    return Object.entries(labels)
+        .map(([key, value]) => `${key}:${value}`)
+        .join(",");
+}
+/** Prefer `data`; fall back to deprecated `context` on log rest params. */
+export function resolveLogData(rest) {
+    if (rest?.data !== undefined) {
+        return rest.data;
+    }
+    if (rest?.context !== undefined) {
+        return rest.context;
+    }
+    return undefined;
+}
+//# sourceMappingURL=log-scope.js.map

package/dist/shared/log/log-scope.js.map

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

package/dist/shared/utils/config-path.utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Directory containing a config file — anchor for paths declared **inside** that file.
+ */
+export declare function getConfigFileDir(configFilePath: string): string;
+/**
+ * Resolve a path from a config file's directory.
+ *
+ * - Absolute `pathInConfig` → returned as-is
+ * - Relative `pathInConfig` → `resolve(dirname(configFilePath), pathInConfig)`
+ *
+ * **Not** relative to `process.cwd()`. See `.cursor/skills/config-file-relative-paths/SKILL.md`.
+ */
+export declare function resolvePathFromConfigFile(configFilePath: string, pathInConfig: string): string;
+/**
+ * Resolve a path from an explicit base directory (e.g. task package dir for `entry`).
+ * Same rules as {@link resolvePathFromConfigFile}, but base is already known.
+ */
+export declare function resolvePathFromBaseDir(baseDir: string, path: string): string;
+/**
+ * Resolve a path from `cwd` — for **discovering** config files, not for fields inside them.
+ */
+export declare function resolvePathFromCwd(cwd: string, path: string): string;
+export declare function pathExists(path: string): Promise<boolean>;
+export interface ResolveFirstExistingPathOptions {
+    /** When set, only this path is tried (resolved from `cwd` if relative). */
+    explicitPath?: string;
+    /** Relative to `cwd`, tried in order when `explicitPath` is omitted. */
+    candidatePaths: string[];
+}
+/**
+ * Find the first existing file path: optional explicit path, else scan `candidatePaths` under `cwd`.
+ */
+export declare function resolveFirstExistingPath(cwd: string, options: ResolveFirstExistingPathOptions): Promise<string | null>;
+/** `file://` href for Node dynamic `import()` of a local module. */
+export declare function toFileImportHref(filePath: string): string;
+/** Native ESM import of a `.js` / `.mjs` config; supports `export default` or named export object. */
+export declare function importJsConfigModule(configPath: string): Promise<unknown>;
+//# sourceMappingURL=config-path.utils.d.ts.map

package/dist/shared/utils/config-path.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-path.utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/config-path.utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAM9F;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,MAAM,WAAW,+BAA+B;IAC5C,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,cAAc,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,+BAA+B,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,sGAAsG;AACtG,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/E"}

package/dist/shared/utils/config-path.utils.js

@@ -0,0 +1,85 @@
+import { access } from "node:fs/promises";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+/**
+ * Directory containing a config file — anchor for paths declared **inside** that file.
+ */
+export function getConfigFileDir(configFilePath) {
+    return dirname(configFilePath);
+}
+/**
+ * Resolve a path from a config file's directory.
+ *
+ * - Absolute `pathInConfig` → returned as-is
+ * - Relative `pathInConfig` → `resolve(dirname(configFilePath), pathInConfig)`
+ *
+ * **Not** relative to `process.cwd()`. See `.cursor/skills/config-file-relative-paths/SKILL.md`.
+ */
+export function resolvePathFromConfigFile(configFilePath, pathInConfig) {
+    const trimmed = pathInConfig.trim();
+    if (isAbsolute(trimmed)) {
+        return trimmed;
+    }
+    return resolve(getConfigFileDir(configFilePath), trimmed);
+}
+/**
+ * Resolve a path from an explicit base directory (e.g. task package dir for `entry`).
+ * Same rules as {@link resolvePathFromConfigFile}, but base is already known.
+ */
+export function resolvePathFromBaseDir(baseDir, path) {
+    const trimmed = path.trim();
+    if (isAbsolute(trimmed)) {
+        return trimmed;
+    }
+    return resolve(baseDir, trimmed);
+}
+/**
+ * Resolve a path from `cwd` — for **discovering** config files, not for fields inside them.
+ */
+export function resolvePathFromCwd(cwd, path) {
+    const trimmed = path.trim();
+    if (isAbsolute(trimmed)) {
+        return trimmed;
+    }
+    return resolve(cwd, trimmed);
+}
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find the first existing file path: optional explicit path, else scan `candidatePaths` under `cwd`.
+ */
+export async function resolveFirstExistingPath(cwd, options) {
+    const { explicitPath, candidatePaths } = options;
+    if (explicitPath != null && explicitPath.trim() !== "") {
+        const resolved = resolvePathFromCwd(cwd, explicitPath);
+        return (await pathExists(resolved)) ? resolved : null;
+    }
+    for (const candidate of candidatePaths) {
+        const resolved = join(cwd, candidate);
+        if (await pathExists(resolved)) {
+            return resolved;
+        }
+    }
+    return null;
+}
+/** `file://` href for Node dynamic `import()` of a local module. */
+export function toFileImportHref(filePath) {
+    const trimmed = filePath.trim();
+    if (trimmed.includes("://")) {
+        return trimmed;
+    }
+    return pathToFileURL(trimmed).href;
+}
+/** Native ESM import of a `.js` / `.mjs` config; supports `export default` or named export object. */
+export async function importJsConfigModule(configPath) {
+    const mod = await import(toFileImportHref(configPath));
+    return mod.default ?? mod;
+}
+//# sourceMappingURL=config-path.utils.js.map

package/dist/shared/utils/config-path.utils.js.map

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

package/dist/shared/utils/error.utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normalize unknown catch / rejection values to {@link Error}.
+ *
+ * `catch` and Promise rejections are typed `unknown` because `throw` can be
+ * anything (string, number, plain object). Call sites that need `.message`,
+ * re-throw, or `instanceof Error` checks should normalize first.
+ */
+export declare function toError(value: unknown): Error;
+/** Error message safe for log `context` fields (JSON-serializable). */
+export declare function getErrorMessage(value: unknown): string;
+//# sourceMappingURL=error.utils.d.ts.map

package/dist/shared/utils/error.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/error.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEtD"}

package/dist/shared/utils/error.utils.js

@@ -0,0 +1,15 @@
+/**
+ * Normalize unknown catch / rejection values to {@link Error}.
+ *
+ * `catch` and Promise rejections are typed `unknown` because `throw` can be
+ * anything (string, number, plain object). Call sites that need `.message`,
+ * re-throw, or `instanceof Error` checks should normalize first.
+ */
+export function toError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+/** Error message safe for log `context` fields (JSON-serializable). */
+export function getErrorMessage(value) {
+    return toError(value).message;
+}
+//# sourceMappingURL=error.utils.js.map

package/dist/shared/utils/error.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.utils.js","sourceRoot":"","sources":["../../../src/shared/utils/error.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAClC,CAAC"}

package/dist/shared/utils/id.utils.d.ts

@@ -0,0 +1,3 @@
+/** RFC 4122 v4 UUID for trace / correlation ids. Requires Node 18+ (`engines` in package.json). */
+export declare function generateUniqueId(): string;
+//# sourceMappingURL=id.utils.d.ts.map

package/dist/shared/utils/id.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/id.utils.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/shared/utils/id.utils.js

@@ -0,0 +1,5 @@
+/** RFC 4122 v4 UUID for trace / correlation ids. Requires Node 18+ (`engines` in package.json). */
+export function generateUniqueId() {
+    return globalThis.crypto.randomUUID();
+}
+//# sourceMappingURL=id.utils.js.map

package/dist/shared/utils/id.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.utils.js","sourceRoot":"","sources":["../../../src/shared/utils/id.utils.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,UAAU,gBAAgB;IAC5B,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AAC1C,CAAC"}

package/dist/supabase.js

@@ -53,7 +53,7 @@ export class SupabaseInitializer {
         const authUrl = supabaseNeedAuthUrl;
         const authAnonKey = supabaseNeedAuthAnonKey;
         if (!mainUrl || !mainAnonKey) {
-            throw new Error("Missing required Supabase environment variables: VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY");
+            throw new Error("Missing required Supabase environment variables: SUPABASE_URL, SUPABASE_ANON_KEY");
         }
         return {
             main: { url: mainUrl, anonKey: mainAnonKey },

package/dist/supabase.js.map

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

package/dist/task/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Task domain public API — curated re-exports only.
+ * Internal modules (local-task-registry, task-repo-context, task.utils) stay private.
+ */
+export { CategoryTask, ResultCode, TaskStatus, TaskStatusAction, } from "./task.interface";
+export type { Task, TaskDetails, TaskFlow } from "./task.interface";
+export { patchChangeTaskStatus, patchChangeTaskStatusSchema, patchClaimTask, patchClaimTaskSchema, patchTaskProgress, patchTaskProgressSchema, } from "./task.api";
+export type { PatchChangeTaskStatusPayload, PatchClaimTaskPayload, PatchTaskProgressPayload, } from "./task.api";
+export { postTask, postTaskSchema } from "./task-post.api";
+export type { PostTaskPayload } from "./task-post.api";
+export { TaskManager } from "./task-manager";
+export type { PrepareTaskFailureReason, PrepareTaskParams, PrepareTaskResponse, RegisterTasksOptions, RegisterTasksResult, } from "./task-manager";
+export { TaskRepoValidation } from "./task-repo-validation";
+export type { TaskRepoValidationFailureReason, ValidateTaskRepoAndParamsInput, ValidateTaskRepoAndParamsResult, } from "./task-repo-validation";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACN,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,YAAY,CAAC;AACpB,YAAY,EACX,4BAA4B,EAC5B,qBAAqB,EACrB,wBAAwB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EACX,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EACX,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,GAC/B,MAAM,wBAAwB,CAAC"}

package/dist/task/index.js

@@ -0,0 +1,14 @@
+/**
+ * Task domain public API — curated re-exports only.
+ * Internal modules (local-task-registry, task-repo-context, task.utils) stay private.
+ */
+// task.interface
+export { CategoryTask, ResultCode, TaskStatus, TaskStatusAction, } from "./task.interface";
+// task.api
+export { patchChangeTaskStatus, patchChangeTaskStatusSchema, patchClaimTask, patchClaimTaskSchema, patchTaskProgress, patchTaskProgressSchema, } from "./task.api";
+export { postTask, postTaskSchema } from "./task-post.api";
+// task-manager
+export { TaskManager } from "./task-manager";
+// task-repo-validation
+export { TaskRepoValidation } from "./task-repo-validation";
+//# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iBAAiB;AACjB,OAAO,EACN,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAG1B,WAAW;AACX,OAAO,EACN,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,GACvB,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG3D,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAS7C,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}