@jingyi0605/codingns 0.1.3 → 0.1.5

package/dist/server/modules/butler/patrol-plan-service.d.ts

@@ -0,0 +1,54 @@
+import type { ButlerProjectRepository } from "../../storage/repositories/butler-project-repository.js";
+import type { PatrolPlanRepository } from "../../storage/repositories/patrol-plan-repository.js";
+declare const TRIGGER_TYPES: readonly ["manual", "interval", "cron"];
+declare const EXECUTION_MODES: readonly ["readonly", "controlled"];
+export interface PatrolPlanView {
+    id: string;
+    projectId: string;
+    name: string;
+    triggerType: (typeof TRIGGER_TYPES)[number];
+    triggerConfig: Record<string, unknown>;
+    executionMode: (typeof EXECUTION_MODES)[number];
+    patrolScope: Record<string, unknown>;
+    enabled: boolean;
+    lastScheduledAt: string | null;
+    nextRunAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreatePatrolPlanInput {
+    name: string;
+    triggerType: (typeof TRIGGER_TYPES)[number];
+    triggerConfig: Record<string, unknown>;
+    executionMode: (typeof EXECUTION_MODES)[number];
+    patrolScope: Record<string, unknown>;
+    enabled?: boolean;
+}
+export interface UpdatePatrolPlanInput {
+    name?: string;
+    triggerConfig?: Record<string, unknown>;
+    executionMode?: (typeof EXECUTION_MODES)[number];
+    patrolScope?: Record<string, unknown>;
+    enabled?: boolean;
+    lastScheduledAt?: string | null;
+    nextRunAt?: string | null;
+}
+export interface PatrolScheduleContext {
+    referenceAt: string;
+    source: "create" | "update" | "scheduler";
+}
+export declare class PatrolPlanService {
+    private readonly butlerProjectRepository;
+    private readonly patrolPlanRepository;
+    constructor(butlerProjectRepository: ButlerProjectRepository, patrolPlanRepository: PatrolPlanRepository);
+    listPlans(projectId: string, filters?: {
+        enabled?: boolean;
+        executionMode?: PatrolPlanView["executionMode"];
+    }): PatrolPlanView[];
+    createPlan(projectId: string, input: CreatePatrolPlanInput): PatrolPlanView;
+    updatePlan(projectId: string, planId: string, input: UpdatePatrolPlanInput): PatrolPlanView;
+    listDuePlans(referenceTime: string, limit?: number): PatrolPlanView[];
+    markPlanScheduled(projectId: string, planId: string, scheduledAt: string): PatrolPlanView;
+    private ensureProject;
+}
+export {};

package/dist/server/modules/butler/patrol-plan-service.js

@@ -0,0 +1,272 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+const TRIGGER_TYPES = ["manual", "interval", "cron"];
+const EXECUTION_MODES = ["readonly", "controlled"];
+export class PatrolPlanService {
+    butlerProjectRepository;
+    patrolPlanRepository;
+    constructor(butlerProjectRepository, patrolPlanRepository) {
+        this.butlerProjectRepository = butlerProjectRepository;
+        this.patrolPlanRepository = patrolPlanRepository;
+    }
+    listPlans(projectId, filters) {
+        this.ensureProject(projectId);
+        const records = this.patrolPlanRepository.listByProject(projectId, {
+            enabled: filters?.enabled ? 1 : filters?.enabled === false ? 0 : undefined,
+            executionMode: filters?.executionMode
+        });
+        return records.map(mapPlanRecord);
+    }
+    createPlan(projectId, input) {
+        this.ensureProject(projectId);
+        validateTriggerType(input.triggerType);
+        validateExecutionMode(input.executionMode);
+        const timestamp = nowIso();
+        const enabled = input.enabled !== false;
+        const record = {
+            id: createId(),
+            projectId,
+            name: requireNonEmptyText(input.name, "name", "巡视计划名称不能为空"),
+            triggerType: input.triggerType,
+            triggerConfigJson: JSON.stringify(input.triggerConfig),
+            executionMode: input.executionMode,
+            patrolScopeJson: JSON.stringify(input.patrolScope),
+            enabled: enabled ? 1 : 0,
+            lastScheduledAt: null,
+            nextRunAt: enabled
+                ? computeNextRunAt(input.triggerType, input.triggerConfig, {
+                    referenceAt: timestamp,
+                    source: "create"
+                })
+                : null,
+            createdAt: timestamp,
+            updatedAt: timestamp
+        };
+        return mapPlanRecord(this.patrolPlanRepository.create(record));
+    }
+    updatePlan(projectId, planId, input) {
+        this.ensureProject(projectId);
+        const existing = this.patrolPlanRepository.findById(planId);
+        if (!existing) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "PATROL_PLAN_NOT_FOUND",
+                detail: "巡视计划不存在"
+            });
+        }
+        if (existing.projectId !== projectId) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "PATROL_PLAN_NOT_FOUND",
+                detail: "当前项目下不存在该巡视计划"
+            });
+        }
+        const nextEnabled = input.enabled !== undefined ? input.enabled : existing.enabled === 1;
+        const triggerConfig = input.triggerConfig
+            ? input.triggerConfig
+            : parseJsonObject(existing.triggerConfigJson);
+        const updated = {
+            ...existing,
+            name: input.name?.trim() || existing.name,
+            triggerConfigJson: JSON.stringify(triggerConfig),
+            executionMode: input.executionMode ?? existing.executionMode,
+            patrolScopeJson: input.patrolScope ? JSON.stringify(input.patrolScope) : existing.patrolScopeJson,
+            enabled: nextEnabled ? 1 : 0,
+            lastScheduledAt: input.lastScheduledAt ?? existing.lastScheduledAt,
+            nextRunAt: resolveNextRunAtForUpdate(existing, triggerConfig, input, nextEnabled),
+            updatedAt: nowIso()
+        };
+        validateExecutionMode(updated.executionMode);
+        const record = this.patrolPlanRepository.update(updated);
+        if (!record) {
+            throw new AppError({
+                statusCode: 500,
+                errorCode: "PATROL_PLAN_UPDATE_FAILED",
+                detail: "巡视计划更新失败"
+            });
+        }
+        return mapPlanRecord(record);
+    }
+    listDuePlans(referenceTime, limit = 50) {
+        return this.patrolPlanRepository.listDue(referenceTime, limit).map(mapPlanRecord);
+    }
+    markPlanScheduled(projectId, planId, scheduledAt) {
+        const existing = this.patrolPlanRepository.findById(planId);
+        if (!existing || existing.projectId !== projectId) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "PATROL_PLAN_NOT_FOUND",
+                detail: "当前项目下不存在该巡视计划"
+            });
+        }
+        const updated = {
+            ...existing,
+            lastScheduledAt: scheduledAt,
+            nextRunAt: existing.enabled === 1
+                ? computeNextRunAt(existing.triggerType, parseJsonObject(existing.triggerConfigJson), {
+                    referenceAt: scheduledAt,
+                    source: "scheduler"
+                })
+                : null,
+            updatedAt: nowIso()
+        };
+        const record = this.patrolPlanRepository.update(updated);
+        if (!record) {
+            throw new AppError({
+                statusCode: 500,
+                errorCode: "PATROL_PLAN_UPDATE_FAILED",
+                detail: "巡视计划调度推进失败"
+            });
+        }
+        return mapPlanRecord(record);
+    }
+    ensureProject(projectId) {
+        const project = this.butlerProjectRepository.findById(projectId);
+        if (!project) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "BUTLER_PROJECT_NOT_FOUND",
+                detail: "代码助手项目不存在"
+            });
+        }
+        return project;
+    }
+}
+function mapPlanRecord(record) {
+    return {
+        id: record.id,
+        projectId: record.projectId,
+        name: record.name,
+        triggerType: record.triggerType,
+        triggerConfig: JSON.parse(record.triggerConfigJson),
+        executionMode: record.executionMode,
+        patrolScope: JSON.parse(record.patrolScopeJson),
+        enabled: record.enabled === 1,
+        lastScheduledAt: record.lastScheduledAt,
+        nextRunAt: record.nextRunAt,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt
+    };
+}
+function validateTriggerType(value) {
+    if (!TRIGGER_TYPES.includes(value)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_TRIGGER_TYPE",
+            detail: "triggerType 无效",
+            field: "triggerType"
+        });
+    }
+}
+function validateExecutionMode(value) {
+    if (!EXECUTION_MODES.includes(value)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_EXECUTION_MODE",
+            detail: "executionMode 无效",
+            field: "executionMode"
+        });
+    }
+}
+function resolveNextRunAtForUpdate(existing, triggerConfig, input, enabled) {
+    if (input.nextRunAt !== undefined) {
+        return input.nextRunAt;
+    }
+    if (!enabled) {
+        return null;
+    }
+    if (existing.enabled === 0 || existing.nextRunAt === null || input.triggerConfig) {
+        return computeNextRunAt(existing.triggerType, triggerConfig, {
+            referenceAt: nowIso(),
+            source: "update"
+        });
+    }
+    return existing.nextRunAt;
+}
+function computeNextRunAt(triggerType, triggerConfig, context) {
+    if (triggerType === "manual") {
+        return null;
+    }
+    if (triggerType === "interval") {
+        return computeIntervalNextRunAt(triggerConfig, context.referenceAt);
+    }
+    if (triggerType === "cron") {
+        return computeCronNextRunAt(triggerConfig, context.referenceAt);
+    }
+    return null;
+}
+function computeIntervalNextRunAt(triggerConfig, referenceAt) {
+    const intervalMs = toPositiveInteger(triggerConfig.seconds) * 1000
+        || toPositiveInteger(triggerConfig.minutes) * 60 * 1000
+        || toPositiveInteger(triggerConfig.hours) * 60 * 60 * 1000;
+    if (!intervalMs) {
+        return null;
+    }
+    return new Date(new Date(referenceAt).getTime() + intervalMs).toISOString();
+}
+function computeCronNextRunAt(triggerConfig, referenceAt) {
+    const minute = normalizeCronMinute(triggerConfig.minute);
+    const hour = normalizeCronHour(triggerConfig.hour);
+    const daysOfWeek = normalizeCronDaysOfWeek(triggerConfig.daysOfWeek);
+    const cursor = new Date(referenceAt);
+    cursor.setSeconds(0, 0);
+    cursor.setMinutes(cursor.getMinutes() + 1);
+    for (let index = 0; index < 60 * 24 * 8; index += 1) {
+        if (cursor.getMinutes() === minute
+            && (hour === null || cursor.getHours() === hour)
+            && (daysOfWeek === null || daysOfWeek.includes(cursor.getDay()))) {
+            return cursor.toISOString();
+        }
+        cursor.setMinutes(cursor.getMinutes() + 1);
+    }
+    return null;
+}
+function normalizeCronMinute(value) {
+    const minute = toPositiveInteger(value);
+    return minute >= 0 && minute <= 59 ? minute : 0;
+}
+function normalizeCronHour(value) {
+    const hour = toPositiveInteger(value);
+    return hour >= 0 && hour <= 23 ? hour : null;
+}
+function normalizeCronDaysOfWeek(value) {
+    if (!Array.isArray(value)) {
+        return null;
+    }
+    const days = value
+        .map((item) => toPositiveInteger(item))
+        .filter((item) => item >= 0 && item <= 6);
+    return days.length > 0 ? days : null;
+}
+function toPositiveInteger(value) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return 0;
+    }
+    const normalized = Math.floor(value);
+    return normalized > 0 || normalized === 0 ? normalized : 0;
+}
+function parseJsonObject(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : {};
+    }
+    catch {
+        return {};
+    }
+}
+function requireNonEmptyText(value, field, detail) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail,
+            field
+        });
+    }
+    return normalized;
+}
+//# sourceMappingURL=patrol-plan-service.js.map

package/dist/server/modules/butler/patrol-plan-service.js.map

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

package/dist/server/modules/butler/patrol-run-service.d.ts

@@ -0,0 +1,60 @@
+import type { ButlerProjectRepository } from "../../storage/repositories/butler-project-repository.js";
+import type { PatrolRunRepository } from "../../storage/repositories/patrol-run-repository.js";
+import type { PatrolPlanRepository } from "../../storage/repositories/patrol-plan-repository.js";
+export interface PatrolRunView {
+    id: string;
+    projectId: string;
+    planId: string | null;
+    triggeredBy: string;
+    triggerRef: string | null;
+    butlerSessionId: string | null;
+    status: string;
+    summary: string | null;
+    riskLevel: string | null;
+    suggestions: string[];
+    startedAt: string | null;
+    finishedAt: string | null;
+    createdAt: string;
+}
+export interface StartPatrolRunInput {
+    planId?: string | null;
+    triggeredBy?: string;
+    triggerRef?: string | null;
+    butlerSessionId?: string | null;
+    suggestions?: string[];
+}
+export interface MarkPatrolRunRunningInput {
+    butlerSessionId?: string | null;
+    startedAt?: string | null;
+}
+export interface CompletePatrolRunInput {
+    status: "succeeded" | "failed" | "cancelled";
+    summary: string | null;
+    riskLevel: PatrolRunView["riskLevel"];
+    suggestions: string[];
+    finishedAt?: string | null;
+}
+export interface ExpireStaleRunningRunsInput {
+    referenceAt?: string;
+    staleTimeoutMs?: number;
+    summary?: string;
+}
+export declare class PatrolRunService {
+    private readonly butlerProjectRepository;
+    private readonly patrolPlanRepository;
+    private readonly patrolRunRepository;
+    constructor(butlerProjectRepository: ButlerProjectRepository, patrolPlanRepository: PatrolPlanRepository, patrolRunRepository: PatrolRunRepository);
+    listRuns(projectId: string, filters?: {
+        status?: string;
+    }): PatrolRunView[];
+    startRun(projectId: string, input: StartPatrolRunInput): PatrolRunView;
+    hasRunningRun(projectId: string): boolean;
+    expireStaleRunningRuns(projectId: string, input?: ExpireStaleRunningRunsInput): PatrolRunView[];
+    getRun(projectId: string, runId: string): PatrolRunView;
+    getRunById(runId: string): PatrolRunView;
+    markRunRunning(runId: string, input?: MarkPatrolRunRunningInput): PatrolRunView;
+    completeRun(runId: string, input: CompletePatrolRunInput): PatrolRunView;
+    private ensureProject;
+    private getRunRecordOrThrow;
+    private updateRunRecord;
+}

package/dist/server/modules/butler/patrol-run-service.js

@@ -0,0 +1,185 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+const DEFAULT_STALE_TIMEOUT_MS = 20 * 60_000;
+export class PatrolRunService {
+    butlerProjectRepository;
+    patrolPlanRepository;
+    patrolRunRepository;
+    constructor(butlerProjectRepository, patrolPlanRepository, patrolRunRepository) {
+        this.butlerProjectRepository = butlerProjectRepository;
+        this.patrolPlanRepository = patrolPlanRepository;
+        this.patrolRunRepository = patrolRunRepository;
+    }
+    listRuns(projectId, filters) {
+        this.ensureProject(projectId);
+        const records = this.patrolRunRepository.listByProject(projectId, {
+            status: filters?.status
+        });
+        return records.map(mapRunRecord);
+    }
+    startRun(projectId, input) {
+        this.ensureProject(projectId);
+        if (input.planId && !this.patrolPlanRepository.findById(input.planId)) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "PATROL_PLAN_NOT_FOUND",
+                detail: "关联巡视计划不存在"
+            });
+        }
+        const timestamp = nowIso();
+        const suggestions = (input.suggestions ?? []).filter((item) => item.trim().length > 0);
+        const record = {
+            id: createId(),
+            projectId,
+            planId: input.planId ?? null,
+            triggeredBy: input.triggeredBy ?? "user",
+            triggerRef: input.triggerRef ?? null,
+            butlerSessionId: input.butlerSessionId ?? null,
+            status: "queued",
+            summary: null,
+            riskLevel: null,
+            suggestionsJson: JSON.stringify(suggestions),
+            startedAt: null,
+            finishedAt: null,
+            createdAt: timestamp
+        };
+        return mapRunRecord(this.patrolRunRepository.create(record));
+    }
+    hasRunningRun(projectId) {
+        this.ensureProject(projectId);
+        return this.patrolRunRepository.listRunningByProject(projectId).length > 0;
+    }
+    expireStaleRunningRuns(projectId, input = {}) {
+        this.ensureProject(projectId);
+        const referenceAt = input.referenceAt ?? nowIso();
+        const staleTimeoutMs = input.staleTimeoutMs ?? DEFAULT_STALE_TIMEOUT_MS;
+        const staleSummary = input.summary ?? "巡视执行超时，系统已自动回收该运行";
+        const staleRecords = this.patrolRunRepository.listRunningByProject(projectId).filter((record) => {
+            const baseline = record.startedAt ?? record.createdAt;
+            return isStaleRun(referenceAt, baseline, staleTimeoutMs);
+        });
+        return staleRecords.map((record) => this.completeRun(record.id, {
+            status: "failed",
+            summary: staleSummary,
+            riskLevel: "high",
+            suggestions: ["检查 provider 会话状态并重试巡视"],
+            finishedAt: referenceAt
+        }));
+    }
+    getRun(projectId, runId) {
+        this.ensureProject(projectId);
+        const record = this.getRunRecordOrThrow(runId);
+        if (record.projectId !== projectId) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "PATROL_RUN_NOT_FOUND",
+                detail: "当前项目下不存在该巡视记录"
+            });
+        }
+        return mapRunRecord(record);
+    }
+    getRunById(runId) {
+        return mapRunRecord(this.getRunRecordOrThrow(runId));
+    }
+    markRunRunning(runId, input = {}) {
+        const existing = this.getRunRecordOrThrow(runId);
+        const timestamp = input.startedAt ?? nowIso();
+        const updated = {
+            ...existing,
+            butlerSessionId: input.butlerSessionId ?? existing.butlerSessionId,
+            status: "running",
+            startedAt: existing.startedAt ?? timestamp
+        };
+        return mapRunRecord(this.updateRunRecord(updated));
+    }
+    completeRun(runId, input) {
+        const existing = this.getRunRecordOrThrow(runId);
+        if (isTerminalRunStatus(existing.status)) {
+            return mapRunRecord(existing);
+        }
+        const updated = {
+            ...existing,
+            status: input.status,
+            summary: input.summary,
+            riskLevel: input.riskLevel,
+            suggestionsJson: JSON.stringify(input.suggestions.filter((item) => item.trim().length > 0)),
+            finishedAt: input.finishedAt ?? nowIso()
+        };
+        return mapRunRecord(this.updateRunRecord(updated));
+    }
+    ensureProject(projectId) {
+        const project = this.butlerProjectRepository.findById(projectId);
+        if (!project) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "BUTLER_PROJECT_NOT_FOUND",
+                detail: "代码助手项目不存在"
+            });
+        }
+        return project;
+    }
+    getRunRecordOrThrow(runId) {
+        const record = this.patrolRunRepository.findById(runId);
+        if (!record) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "PATROL_RUN_NOT_FOUND",
+                detail: "巡视记录不存在"
+            });
+        }
+        return record;
+    }
+    updateRunRecord(record) {
+        const updated = this.patrolRunRepository.update(record);
+        if (!updated) {
+            throw new AppError({
+                statusCode: 500,
+                errorCode: "PATROL_RUN_UPDATE_FAILED",
+                detail: "巡视记录更新失败"
+            });
+        }
+        return updated;
+    }
+}
+function mapRunRecord(record) {
+    return {
+        id: record.id,
+        projectId: record.projectId,
+        planId: record.planId,
+        triggeredBy: record.triggeredBy,
+        triggerRef: record.triggerRef,
+        butlerSessionId: record.butlerSessionId,
+        status: record.status,
+        summary: record.summary,
+        riskLevel: record.riskLevel,
+        suggestions: parseSuggestions(record.suggestionsJson),
+        startedAt: record.startedAt,
+        finishedAt: record.finishedAt,
+        createdAt: record.createdAt
+    };
+}
+function parseSuggestions(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            return [];
+        }
+        return parsed.filter((item) => typeof item === "string");
+    }
+    catch {
+        return [];
+    }
+}
+function isStaleRun(referenceAt, baselineAt, staleTimeoutMs) {
+    const reference = Date.parse(referenceAt);
+    const baseline = Date.parse(baselineAt);
+    if (!Number.isFinite(reference) || !Number.isFinite(baseline)) {
+        return false;
+    }
+    return reference - baseline >= staleTimeoutMs;
+}
+function isTerminalRunStatus(status) {
+    return status === "succeeded" || status === "failed" || status === "cancelled";
+}
+//# sourceMappingURL=patrol-run-service.js.map

package/dist/server/modules/butler/patrol-run-service.js.map

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

package/dist/server/modules/butler/patrol-scheduler.d.ts

@@ -0,0 +1,36 @@
+import type { PatrolPlanService } from "./patrol-plan-service.js";
+import type { PatrolExecutionService } from "./patrol-execution-service.js";
+import type { PatrolRunService } from "./patrol-run-service.js";
+interface PatrolSchedulerLogger {
+    error(message: string, detail?: unknown): void;
+}
+interface PatrolSchedulerOptions {
+    intervalMs?: number;
+    staleTimeoutMs?: number;
+    logger?: PatrolSchedulerLogger;
+    now?: () => string;
+}
+/**
+ * 巡视计划后台调度器。
+ *
+ * 第一版只做两件事：
+ * 1. 周期扫描已到期的计划
+ * 2. 为到期计划登记一条巡视运行记录，并推进下一次触发时间
+ */
+export declare class PatrolScheduler {
+    private readonly patrolPlanService;
+    private readonly patrolRunService;
+    private readonly patrolExecutionService;
+    private readonly intervalMs;
+    private readonly staleTimeoutMs;
+    private readonly logger;
+    private readonly now;
+    private timer;
+    private ticking;
+    constructor(patrolPlanService: PatrolPlanService, patrolRunService: PatrolRunService, patrolExecutionService: PatrolExecutionService, options?: PatrolSchedulerOptions);
+    start(): void;
+    dispose(): Promise<void>;
+    runOnce(): Promise<void>;
+    private tick;
+}
+export {};