@jingyi0605/codingns 0.2.0 → 0.3.0

package/dist/server/modules/tasks/scheduler-metrics.js

@@ -0,0 +1,92 @@
+export class SchedulerMetrics {
+    schedulers = new Map();
+    recordTick(observation) {
+        const state = this.getState(observation.schedulerName);
+        const durationMs = Math.max(0, observation.durationMs);
+        const errorCount = Math.max(0, observation.errorCount ?? 0);
+        state.tickTotal += 1;
+        state.taskCountTotal += Math.max(0, observation.taskCount);
+        state.errorTotal += errorCount;
+        state.lastTickAt = observation.referenceAt;
+        state.lastDurationMs = durationMs;
+        state.lastTaskCount = Math.max(0, observation.taskCount);
+        state.lastIdle = observation.idle;
+        state.lastErrorCount = errorCount;
+        state.nextDelayMs = observation.nextDelayMs ?? null;
+        state.idleStreak = Math.max(0, observation.idleStreak ?? 0);
+        if (observation.idle) {
+            state.idleTickTotal += 1;
+        }
+        state.durationMs.count += 1;
+        state.durationMs.total += durationMs;
+        state.durationMs.max = Math.max(state.durationMs.max, durationMs);
+        state.durationMs.min =
+            state.durationMs.min === null ? durationMs : Math.min(state.durationMs.min, durationMs);
+    }
+    observe() {
+        return {
+            schedulers: Object.fromEntries([...this.schedulers.entries()].map(([name, state]) => [
+                name,
+                {
+                    tickTotal: state.tickTotal,
+                    idleTickTotal: state.idleTickTotal,
+                    errorTotal: state.errorTotal,
+                    taskCountTotal: state.taskCountTotal,
+                    durationMs: snapshotDuration(state.durationMs),
+                    lastTickAt: state.lastTickAt,
+                    lastDurationMs: state.lastDurationMs,
+                    lastTaskCount: state.lastTaskCount,
+                    lastIdle: state.lastIdle,
+                    lastErrorCount: state.lastErrorCount,
+                    nextDelayMs: state.nextDelayMs,
+                    idleStreak: state.idleStreak
+                }
+            ]))
+        };
+    }
+    getState(name) {
+        const existing = this.schedulers.get(name);
+        if (existing) {
+            return existing;
+        }
+        const created = {
+            tickTotal: 0,
+            idleTickTotal: 0,
+            errorTotal: 0,
+            taskCountTotal: 0,
+            durationMs: {
+                count: 0,
+                total: 0,
+                max: 0,
+                min: null
+            },
+            lastTickAt: null,
+            lastDurationMs: null,
+            lastTaskCount: 0,
+            lastIdle: false,
+            lastErrorCount: 0,
+            nextDelayMs: null,
+            idleStreak: 0
+        };
+        this.schedulers.set(name, created);
+        return created;
+    }
+}
+export function resolveAdaptiveSchedulerDelayMs(baseIntervalMs, maxIntervalMs, idleStreak) {
+    const normalizedBase = Math.max(1, Math.floor(baseIntervalMs));
+    const normalizedMax = Math.max(normalizedBase, Math.floor(maxIntervalMs));
+    if (idleStreak <= 0) {
+        return normalizedBase;
+    }
+    return Math.min(normalizedMax, normalizedBase * (2 ** Math.max(0, idleStreak - 1)));
+}
+function snapshotDuration(state) {
+    return {
+        count: state.count,
+        total: state.total,
+        max: state.max,
+        min: state.min,
+        avg: state.count > 0 ? state.total / state.count : 0
+    };
+}
+//# sourceMappingURL=scheduler-metrics.js.map

package/dist/server/modules/tasks/scheduler-metrics.js.map

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

package/dist/server/modules/tasks/task-activity-log.d.ts

@@ -0,0 +1,39 @@
+import type { TaskExecutionLane, TaskStatus } from "./task-types.js";
+export type TaskActivityEventType = "enqueued" | "deduped" | "started" | "finished" | "failed" | "cancelled" | "timeout" | "cache_hit";
+export interface TaskActivityRecord {
+    readonly eventId: string;
+    readonly recordedAt: string;
+    readonly eventType: TaskActivityEventType;
+    readonly taskId: string | null;
+    readonly taskType: string;
+    readonly key: string;
+    readonly executionLane: TaskExecutionLane;
+    readonly source: string | null;
+    readonly status: TaskStatus | null;
+    readonly attempt: number | null;
+    readonly waitMs: number | null;
+    readonly runMs: number | null;
+    readonly errorMessage: string | null;
+}
+export interface TaskActivityEventInput {
+    readonly eventType: TaskActivityEventType;
+    readonly taskId?: string | null;
+    readonly taskType: string;
+    readonly key: string;
+    readonly executionLane: TaskExecutionLane;
+    readonly source?: string | null;
+    readonly status?: TaskStatus | null;
+    readonly attempt?: number | null;
+    readonly waitMs?: number | null;
+    readonly runMs?: number | null;
+    readonly errorMessage?: string | null;
+}
+export declare class TaskActivityLog {
+    private readonly isEnabled;
+    private readonly limit;
+    private readonly records;
+    constructor(isEnabled: () => boolean, limit?: number);
+    record(input: TaskActivityEventInput): void;
+    list(limit?: number): TaskActivityRecord[];
+    clear(): void;
+}

package/dist/server/modules/tasks/task-activity-log.js

@@ -0,0 +1,43 @@
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class TaskActivityLog {
+    isEnabled;
+    limit;
+    records = [];
+    constructor(isEnabled, limit = 200) {
+        this.isEnabled = isEnabled;
+        this.limit = limit;
+    }
+    record(input) {
+        if (!this.isEnabled()) {
+            return;
+        }
+        this.records.unshift({
+            eventId: createId(),
+            recordedAt: nowIso(),
+            eventType: input.eventType,
+            taskId: input.taskId ?? null,
+            taskType: input.taskType,
+            key: input.key,
+            executionLane: input.executionLane,
+            source: input.source ?? null,
+            status: input.status ?? null,
+            attempt: input.attempt ?? null,
+            waitMs: input.waitMs ?? null,
+            runMs: input.runMs ?? null,
+            errorMessage: input.errorMessage ?? null
+        });
+        if (this.records.length > this.limit) {
+            this.records.length = this.limit;
+        }
+    }
+    list(limit = 100) {
+        return this.records.slice(0, Math.max(1, limit)).map((record) => ({
+            ...record
+        }));
+    }
+    clear() {
+        this.records.length = 0;
+    }
+}
+//# sourceMappingURL=task-activity-log.js.map

package/dist/server/modules/tasks/task-activity-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-activity-log.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-activity-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AA2CpD,MAAM,OAAO,eAAe;IAIP;IACA;IAJF,OAAO,GAAyB,EAAE,CAAC;IAEpD,YACmB,SAAwB,EACxB,QAAQ,GAAG;QADX,cAAS,GAAT,SAAS,CAAe;QACxB,UAAK,GAAL,KAAK,CAAM;IAC3B,CAAC;IAEJ,MAAM,CAAC,KAA6B;QAClC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;YACnB,OAAO,EAAE,QAAQ,EAAE;YACnB,UAAU,EAAE,MAAM,EAAE;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;YAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;SACzC,CAAC,CAAC;QAEH,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;QACnC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,GAAG,GAAG;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAChE,GAAG,MAAM;SACV,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/server/modules/tasks/task-helper-client.d.ts

@@ -0,0 +1,11 @@
+import type { TaskHelperProcessHandlerName } from "./task-helper-process-handlers.js";
+export declare class TaskHelperProcessClient {
+    private readonly child;
+    private readonly stdoutReader;
+    private readonly pendingRequests;
+    private nextRequestId;
+    constructor();
+    execute<TResult>(handler: TaskHelperProcessHandlerName, input: unknown, signal?: AbortSignal): Promise<TResult>;
+    private handleResponseLine;
+    private rejectAll;
+}

package/dist/server/modules/tasks/task-helper-client.js

@@ -0,0 +1,132 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import readline from "node:readline";
+import { fileURLToPath } from "node:url";
+export class TaskHelperProcessClient {
+    child;
+    stdoutReader;
+    pendingRequests = new Map();
+    nextRequestId = 1;
+    constructor() {
+        const launch = resolveHelperLaunch();
+        this.child = spawn(launch.command, launch.args, {
+            cwd: process.cwd(),
+            env: process.env,
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        this.stdoutReader = readline.createInterface({
+            input: this.child.stdout
+        });
+        this.stdoutReader.on("line", (line) => {
+            this.handleResponseLine(line);
+        });
+        this.child.stderr.on("data", (chunk) => {
+            const content = String(chunk).trim();
+            if (content) {
+                console.warn(`[task-helper] ${content}`);
+            }
+        });
+        this.child.on("error", (error) => {
+            this.rejectAll(error);
+        });
+        this.child.on("exit", (code, signal) => {
+            this.rejectAll(new Error(`task helper 已退出：code=${code ?? "null"} signal=${signal ?? "null"}`));
+        });
+    }
+    async execute(handler, input, signal) {
+        const id = String(this.nextRequestId++);
+        return await new Promise((resolve, reject) => {
+            let aborted = false;
+            let onAbort = null;
+            if (signal) {
+                onAbort = () => {
+                    aborted = true;
+                    this.pendingRequests.delete(id);
+                    reject(signal.reason ?? new Error("helper task aborted"));
+                };
+                if (signal.aborted) {
+                    onAbort();
+                    return;
+                }
+                signal.addEventListener("abort", onAbort, { once: true });
+            }
+            this.pendingRequests.set(id, {
+                resolve: (value) => {
+                    if (onAbort && signal) {
+                        signal.removeEventListener("abort", onAbort);
+                    }
+                    if (!aborted) {
+                        resolve(value);
+                    }
+                },
+                reject: (error) => {
+                    if (onAbort && signal) {
+                        signal.removeEventListener("abort", onAbort);
+                    }
+                    if (!aborted) {
+                        reject(error);
+                    }
+                }
+            });
+            this.child.stdin.write(`${JSON.stringify({
+                id,
+                handler,
+                input
+            })}\n`, (error) => {
+                if (!error) {
+                    return;
+                }
+                if (onAbort && signal) {
+                    signal.removeEventListener("abort", onAbort);
+                }
+                this.pendingRequests.delete(id);
+                reject(error);
+            });
+        });
+    }
+    handleResponseLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{")) {
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(trimmed);
+        }
+        catch {
+            return;
+        }
+        const pending = this.pendingRequests.get(payload.id);
+        if (!pending) {
+            return;
+        }
+        this.pendingRequests.delete(payload.id);
+        if (payload.ok) {
+            pending.resolve(payload.result);
+            return;
+        }
+        pending.reject(new Error(payload.error));
+    }
+    rejectAll(error) {
+        for (const pending of this.pendingRequests.values()) {
+            pending.reject(error);
+        }
+        this.pendingRequests.clear();
+    }
+}
+function resolveHelperLaunch() {
+    const currentFilePath = fileURLToPath(import.meta.url);
+    const extension = path.extname(currentFilePath);
+    const helperPath = currentFilePath.replace(/task-helper-client\.(ts|js)$/, `task-helper-process${extension}`);
+    if (extension === ".ts") {
+        return {
+            command: process.execPath,
+            args: ["--import", "tsx", helperPath]
+        };
+    }
+    return {
+        command: process.execPath,
+        args: [helperPath]
+    };
+}
+//# sourceMappingURL=task-helper-client.js.map

package/dist/server/modules/tasks/task-helper-client.js.map

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

package/dist/server/modules/tasks/task-helper-process-handlers.d.ts

@@ -0,0 +1,16 @@
+import type { TerminalTemplateRuntimeStatus } from "../../types/domain.js";
+import type { WorkspaceCodeCompositionSummary } from "../workspace/workspace-service.js";
+interface TaskHelperProcessHandlerMap {
+    "workspace.code_composition_scan": (input: {
+        workspacePath: string;
+    }) => WorkspaceCodeCompositionSummary | Promise<WorkspaceCodeCompositionSummary>;
+    "terminal.template_runtime_status_discovery": (input: {
+        items: Array<{
+            templateId: string;
+            port: number;
+        }>;
+    }) => TerminalTemplateRuntimeStatus[] | Promise<TerminalTemplateRuntimeStatus[]>;
+}
+export type TaskHelperProcessHandlerName = keyof TaskHelperProcessHandlerMap;
+export declare function runTaskHelperProcessHandler(handler: TaskHelperProcessHandlerName, input: unknown): Promise<unknown>;
+export {};

package/dist/server/modules/tasks/task-helper-process-handlers.js

@@ -0,0 +1,14 @@
+import { discoverTemplateRuntimeStatuses } from "../terminal/template-port-runtime.js";
+import { readWorkspaceCodeComposition } from "../workspace/workspace-code-composition.js";
+const TASK_HELPER_PROCESS_HANDLERS = {
+    "workspace.code_composition_scan": ({ workspacePath }) => readWorkspaceCodeComposition(workspacePath),
+    "terminal.template_runtime_status_discovery": ({ items }) => discoverTemplateRuntimeStatuses(items)
+};
+export async function runTaskHelperProcessHandler(handler, input) {
+    const handlerFn = TASK_HELPER_PROCESS_HANDLERS[handler];
+    if (!handlerFn) {
+        throw new Error(`未知 helper_process 处理器: ${handler}`);
+    }
+    return await handlerFn(input);
+}
+//# sourceMappingURL=task-helper-process-handlers.js.map

package/dist/server/modules/tasks/task-helper-process-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-helper-process-handlers.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-helper-process-handlers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,EACL,4BAA4B,EAC7B,MAAM,4CAA4C,CAAC;AAYpD,MAAM,4BAA4B,GAAgC;IAChE,iCAAiC,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CACvD,4BAA4B,CAAC,aAAa,CAAC;IAC7C,4CAA4C,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAC1D,+BAA+B,CAAC,KAAK,CAAC;CACzC,CAAC;AAIF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAqC,EACrC,KAAc;IAEd,MAAM,SAAS,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAExD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,0BAA0B,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,SAAS,CAAC,KAAc,CAAC,CAAC;AACzC,CAAC"}

package/dist/server/modules/tasks/task-helper-process.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/server/modules/tasks/task-helper-process.js

@@ -0,0 +1,49 @@
+import readline from "node:readline";
+import { runTaskHelperProcessHandler } from "./task-helper-process-handlers.js";
+const reader = readline.createInterface({
+    input: process.stdin,
+    crlfDelay: Number.POSITIVE_INFINITY
+});
+reader.on("line", (line) => {
+    void handleLine(line);
+});
+async function handleLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return;
+    }
+    let payload;
+    try {
+        payload = JSON.parse(trimmed);
+    }
+    catch (error) {
+        writeResponse({
+            type: "result",
+            id: "unknown",
+            ok: false,
+            error: error instanceof Error ? error.message : "helper request parse failed"
+        });
+        return;
+    }
+    try {
+        const result = await runTaskHelperProcessHandler(payload.handler, payload.input);
+        writeResponse({
+            type: "result",
+            id: payload.id,
+            ok: true,
+            result
+        });
+    }
+    catch (error) {
+        writeResponse({
+            type: "result",
+            id: payload.id,
+            ok: false,
+            error: error instanceof Error ? error.message : "helper task failed"
+        });
+    }
+}
+function writeResponse(payload) {
+    process.stdout.write(`${JSON.stringify(payload)}\n`);
+}
+//# sourceMappingURL=task-helper-process.js.map

package/dist/server/modules/tasks/task-helper-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-helper-process.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-helper-process.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,OAAO,EACL,2BAA2B,EAE5B,MAAM,mCAAmC,CAAC;AAsB3C,MAAM,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC;IACtC,KAAK,EAAE,OAAO,CAAC,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC,iBAAiB;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;IACzB,KAAK,UAAU,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,IAAI,OAA0B,CAAC;IAE/B,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,SAAS;YACb,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B;SAC9E,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjF,aAAa,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,EAAE,EAAE,IAAI;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,oBAAoB;SACrE,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAA2B;IAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/server/modules/tasks/task-lane-executors.d.ts

@@ -0,0 +1,2 @@
+import type { TaskExecutionLane, TaskLaneExecutor } from "./task-types.js";
+export declare function createHostTaskLaneExecutors(): Partial<Record<TaskExecutionLane, TaskLaneExecutor>>;

package/dist/server/modules/tasks/task-lane-executors.js

@@ -0,0 +1,15 @@
+import { TaskHelperProcessClient } from "./task-helper-client.js";
+export function createHostTaskLaneExecutors() {
+    const helperProcessClient = new TaskHelperProcessClient();
+    return {
+        helper_process: {
+            execute: async (definition, input, context) => {
+                if (!definition.helperProcessHandler) {
+                    return await definition.run(input, context);
+                }
+                return await helperProcessClient.execute(definition.helperProcessHandler, input, context.signal);
+            }
+        }
+    };
+}
+//# sourceMappingURL=task-lane-executors.js.map

package/dist/server/modules/tasks/task-lane-executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-lane-executors.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-lane-executors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,MAAM,UAAU,2BAA2B;IACzC,MAAM,mBAAmB,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE1D,OAAO;QACL,cAAc,EAAE;YACd,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;gBAC5C,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC;oBACrC,OAAO,MAAM,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC9C,CAAC;gBAED,OAAO,MAAM,mBAAmB,CAAC,OAAO,CACtC,UAAU,CAAC,oBAA6B,EACxC,KAAK,EACL,OAAO,CAAC,MAAM,CACf,CAAC;YACJ,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/modules/tasks/task-manager.d.ts

@@ -0,0 +1,15 @@
+import type { TaskActivitySink, TaskDefinition, TaskExecutionLane, TaskEnqueueOptions, TaskHandle, TaskLaneExecutor, TaskMetricsSnapshot, TaskSnapshot } from "./task-types.js";
+export declare class TaskManager {
+    private readonly registry;
+    private readonly metrics;
+    private readonly scheduler;
+    constructor(activitySink?: TaskActivitySink | null, laneExecutors?: Partial<Record<TaskExecutionLane, TaskLaneExecutor>>);
+    register<TInput, TResult>(definition: TaskDefinition<TInput, TResult>): void;
+    has(taskType: string): boolean;
+    enqueue<TInput, TResult>(taskType: string, options: TaskEnqueueOptions<TInput>): TaskHandle<TResult>;
+    cancel(taskType: string, key: string, reason?: string): void;
+    recordCacheHit(taskType: string, key: string): void;
+    peek<TResult = unknown>(taskType: string, key: string): TaskSnapshot<TResult> | null;
+    observe(): TaskMetricsSnapshot;
+}
+export declare function createTaskManager(activitySink?: TaskActivitySink | null, laneExecutors?: Partial<Record<TaskExecutionLane, TaskLaneExecutor>>): TaskManager;

package/dist/server/modules/tasks/task-manager.js

@@ -0,0 +1,36 @@
+import { TaskMetrics } from "./task-metrics.js";
+import { TaskRegistry } from "./task-registry.js";
+import { TaskScheduler } from "./task-scheduler.js";
+export class TaskManager {
+    registry = new TaskRegistry();
+    metrics = new TaskMetrics();
+    scheduler;
+    constructor(activitySink = null, laneExecutors = {}) {
+        this.scheduler = new TaskScheduler(this.registry, this.metrics, activitySink, laneExecutors);
+    }
+    register(definition) {
+        this.registry.register(definition);
+    }
+    has(taskType) {
+        return this.registry.has(taskType);
+    }
+    enqueue(taskType, options) {
+        return this.scheduler.enqueue(taskType, options);
+    }
+    cancel(taskType, key, reason) {
+        this.scheduler.cancel(taskType, key, reason);
+    }
+    recordCacheHit(taskType, key) {
+        this.scheduler.recordCacheHit(taskType, key);
+    }
+    peek(taskType, key) {
+        return this.scheduler.peek(taskType, key);
+    }
+    observe() {
+        return this.metrics.observe();
+    }
+}
+export function createTaskManager(activitySink = null, laneExecutors = {}) {
+    return new TaskManager(activitySink, laneExecutors);
+}
+//# sourceMappingURL=task-manager.js.map

package/dist/server/modules/tasks/task-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-manager.js","sourceRoot":"","sources":["../../../../src/modules/tasks/task-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYpD,MAAM,OAAO,WAAW;IACL,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAC9B,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAC5B,SAAS,CAAgB;IAE1C,YACE,eAAwC,IAAI,EAC5C,gBAAsE,EAAE;QAExE,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAC/F,CAAC;IAED,QAAQ,CAAkB,UAA2C;QACnE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,CAAkB,QAAgB,EAAE,OAAmC;QAC5E,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAkB,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,GAAW,EAAE,MAAe;QACnD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,GAAW;QAC1C,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAoB,QAAgB,EAAE,GAAW;QACnD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAU,QAAQ,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAC/B,eAAwC,IAAI,EAC5C,gBAAsE,EAAE;IAExE,OAAO,IAAI,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;AACtD,CAAC"}

package/dist/server/modules/tasks/task-metrics.d.ts

@@ -0,0 +1,9 @@
+import type { TaskCounterMetricName, TaskDurationMetricName, TaskExecutionLane, TaskMetricsSnapshot } from "./task-types.js";
+export declare class TaskMetrics {
+    private readonly totals;
+    private readonly taskTypes;
+    increment(taskType: string, executionLane: TaskExecutionLane, metric: TaskCounterMetricName): void;
+    recordDuration(taskType: string, executionLane: TaskExecutionLane, metric: TaskDurationMetricName, valueMs: number): void;
+    observe(): TaskMetricsSnapshot;
+    private getTaskGroup;
+}

package/dist/server/modules/tasks/task-metrics.js

@@ -0,0 +1,81 @@
+const COUNTER_METRIC_NAMES = [
+    "enqueue",
+    "dedupe",
+    "started",
+    "finished",
+    "failed",
+    "cancelled",
+    "timeout",
+    "cache_hit"
+];
+export class TaskMetrics {
+    totals = createCounterRecord();
+    taskTypes = new Map();
+    increment(taskType, executionLane, metric) {
+        this.totals[metric] += 1;
+        this.getTaskGroup(taskType, executionLane).counters[metric] += 1;
+    }
+    recordDuration(taskType, executionLane, metric, valueMs) {
+        const normalized = Math.max(0, valueMs);
+        const stats = metric === "wait_ms"
+            ? this.getTaskGroup(taskType, executionLane).waitMs
+            : this.getTaskGroup(taskType, executionLane).runMs;
+        stats.count += 1;
+        stats.total += normalized;
+        stats.max = Math.max(stats.max, normalized);
+        stats.min = stats.min === null ? normalized : Math.min(stats.min, normalized);
+    }
+    observe() {
+        const taskTypes = Object.fromEntries([...this.taskTypes.entries()].map(([taskType, group]) => [
+            taskType,
+            {
+                executionLane: group.executionLane,
+                counters: { ...group.counters },
+                waitMs: snapshotDurationStats(group.waitMs),
+                runMs: snapshotDurationStats(group.runMs)
+            }
+        ]));
+        return {
+            totals: { ...this.totals },
+            taskTypes
+        };
+    }
+    getTaskGroup(taskType, executionLane) {
+        const existing = this.taskTypes.get(taskType);
+        if (existing) {
+            return existing;
+        }
+        const created = {
+            executionLane,
+            counters: createCounterRecord(),
+            waitMs: createDurationStats(),
+            runMs: createDurationStats()
+        };
+        this.taskTypes.set(taskType, created);
+        return created;
+    }
+}
+function createCounterRecord() {
+    return COUNTER_METRIC_NAMES.reduce((result, metric) => {
+        result[metric] = 0;
+        return result;
+    }, {});
+}
+function createDurationStats() {
+    return {
+        count: 0,
+        total: 0,
+        max: 0,
+        min: null
+    };
+}
+function snapshotDurationStats(stats) {
+    return {
+        count: stats.count,
+        total: stats.total,
+        max: stats.max,
+        min: stats.min,
+        avg: stats.count > 0 ? stats.total / stats.count : 0
+    };
+}
+//# sourceMappingURL=task-metrics.js.map

package/dist/server/modules/tasks/task-metrics.js.map

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

package/dist/server/modules/tasks/task-registry.d.ts

@@ -0,0 +1,7 @@
+import type { TaskDefinition } from "./task-types.js";
+export declare class TaskRegistry {
+    private readonly definitions;
+    register<TInput, TResult>(definition: TaskDefinition<TInput, TResult>): void;
+    has(taskType: string): boolean;
+    get<TInput, TResult>(taskType: string): TaskDefinition<TInput, TResult>;
+}

package/dist/server/modules/tasks/task-registry.js

@@ -0,0 +1,21 @@
+export class TaskRegistry {
+    definitions = new Map();
+    register(definition) {
+        const existing = this.definitions.get(definition.taskType);
+        if (existing && existing !== definition) {
+            throw new Error(`任务类型已注册: ${definition.taskType}`);
+        }
+        this.definitions.set(definition.taskType, definition);
+    }
+    has(taskType) {
+        return this.definitions.has(taskType);
+    }
+    get(taskType) {
+        const definition = this.definitions.get(taskType);
+        if (!definition) {
+            throw new Error(`未注册的任务类型: ${taskType}`);
+        }
+        return definition;
+    }
+}
+//# sourceMappingURL=task-registry.js.map