@jingyi0605/codingns 0.1.3 → 0.1.5

package/dist/server/modules/butler/patrol-scheduler.js

@@ -0,0 +1,99 @@
+import { nowIso } from "../../shared/utils/time.js";
+const DEFAULT_INTERVAL_MS = 30_000;
+const DEFAULT_STALE_TIMEOUT_MS = 20 * 60_000;
+const MAX_PLANS_PER_TICK = 50;
+/**
+ * 巡视计划后台调度器。
+ *
+ * 第一版只做两件事：
+ * 1. 周期扫描已到期的计划
+ * 2. 为到期计划登记一条巡视运行记录，并推进下一次触发时间
+ */
+export class PatrolScheduler {
+    patrolPlanService;
+    patrolRunService;
+    patrolExecutionService;
+    intervalMs;
+    staleTimeoutMs;
+    logger;
+    now;
+    timer = null;
+    ticking = false;
+    constructor(patrolPlanService, patrolRunService, patrolExecutionService, options = {}) {
+        this.patrolPlanService = patrolPlanService;
+        this.patrolRunService = patrolRunService;
+        this.patrolExecutionService = patrolExecutionService;
+        this.intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.staleTimeoutMs = options.staleTimeoutMs ?? DEFAULT_STALE_TIMEOUT_MS;
+        this.logger = options.logger ?? console;
+        this.now = options.now ?? nowIso;
+    }
+    start() {
+        if (this.timer) {
+            return;
+        }
+        void this.tick();
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, this.intervalMs);
+        this.timer.unref?.();
+    }
+    async dispose() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        while (this.ticking) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+    async runOnce() {
+        await this.tick();
+    }
+    async tick() {
+        if (this.ticking) {
+            return;
+        }
+        this.ticking = true;
+        try {
+            const referenceAt = this.now();
+            const plans = this.patrolPlanService.listDuePlans(referenceAt, MAX_PLANS_PER_TICK);
+            for (const plan of plans) {
+                try {
+                    const expiredRuns = this.patrolRunService.expireStaleRunningRuns(plan.projectId, {
+                        referenceAt,
+                        staleTimeoutMs: this.staleTimeoutMs,
+                        summary: "巡视执行超过调度容忍时长，系统已自动终止并标记失败"
+                    });
+                    if (expiredRuns.length > 0) {
+                        this.logger.error("[patrol-scheduler] stale runs reclaimed", {
+                            projectId: plan.projectId,
+                            runIds: expiredRuns.map((run) => run.id)
+                        });
+                    }
+                    if (this.patrolRunService.hasRunningRun(plan.projectId)) {
+                        continue;
+                    }
+                    const run = this.patrolRunService.startRun(plan.projectId, {
+                        planId: plan.id,
+                        triggeredBy: "scheduler",
+                        triggerRef: `patrol-scheduler:${referenceAt}`
+                    });
+                    await this.patrolExecutionService.executeQueuedRun(run.id);
+                    this.patrolPlanService.markPlanScheduled(plan.projectId, plan.id, referenceAt);
+                }
+                catch (error) {
+                    this.logger.error("[patrol-scheduler] tick plan failed", {
+                        planId: plan.id,
+                        projectId: plan.projectId,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            }
+        }
+        finally {
+            this.ticking = false;
+        }
+    }
+}
+//# sourceMappingURL=patrol-scheduler.js.map

package/dist/server/modules/butler/patrol-scheduler.js.map

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

package/dist/server/modules/butler/project-memory-service.d.ts

@@ -0,0 +1,30 @@
+import type { ButlerProjectRepository } from "../../storage/repositories/butler-project-repository.js";
+import type { ProjectMemory, ProjectMemoryStatus, ProjectMemoryType } from "../../types/domain.js";
+import type { ProjectMemoryRepository } from "../../storage/repositories/project-memory-repository.js";
+interface InputMemory {
+    title?: string;
+    scopePath?: string | null;
+    content?: string;
+    tags?: string[];
+    confidence?: number;
+    status?: ProjectMemoryStatus;
+    memoryType?: ProjectMemoryType;
+    evidence?: Record<string, unknown>;
+}
+export declare class ProjectMemoryService {
+    private readonly projectRepository;
+    private readonly memoryRepository;
+    constructor(projectRepository: ButlerProjectRepository, memoryRepository: ProjectMemoryRepository);
+    listMemories(projectId: string, filters?: {
+        status?: ProjectMemoryStatus;
+        memoryType?: ProjectMemoryType;
+        scopePath?: string;
+        query?: string;
+    }): ProjectMemory[];
+    createMemory(projectId: string, input: InputMemory): ProjectMemory;
+    updateMemory(projectId: string, memoryId: string, input: InputMemory): ProjectMemory;
+    private ensureProject;
+    private requireText;
+    private normalizeConfidence;
+}
+export {};

package/dist/server/modules/butler/project-memory-service.js

@@ -0,0 +1,103 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class ProjectMemoryService {
+    projectRepository;
+    memoryRepository;
+    constructor(projectRepository, memoryRepository) {
+        this.projectRepository = projectRepository;
+        this.memoryRepository = memoryRepository;
+    }
+    listMemories(projectId, filters) {
+        this.ensureProject(projectId);
+        return this.memoryRepository.listByProject(projectId, filters);
+    }
+    createMemory(projectId, input) {
+        const project = this.ensureProject(projectId);
+        const title = this.requireText(input.title, "title");
+        const content = this.requireText(input.content, "content");
+        const confidence = this.normalizeConfidence(input.confidence);
+        const record = {
+            id: createId(),
+            projectId: project.id,
+            sourceButlerSessionId: null,
+            sourceCheckpointId: null,
+            memoryType: input.memoryType ?? "note",
+            title,
+            scopePath: input.scopePath ?? null,
+            content,
+            tags: input.tags ?? [],
+            confidence,
+            status: input.status ?? "candidate",
+            evidence: input.evidence ?? {},
+            supersededBy: null,
+            createdAt: nowIso(),
+            updatedAt: nowIso()
+        };
+        return this.memoryRepository.create(record);
+    }
+    updateMemory(projectId, memoryId, input) {
+        this.ensureProject(projectId);
+        const memory = this.memoryRepository.findById(memoryId);
+        if (!memory) {
+            throw new AppError({ statusCode: 404, errorCode: "MEMORY_NOT_FOUND", detail: "记忆不存在" });
+        }
+        if (memory.projectId !== projectId) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "MEMORY_NOT_FOUND",
+                detail: "当前项目下不存在该记忆"
+            });
+        }
+        if (input.title) {
+            memory.title = this.requireText(input.title, "title");
+        }
+        if (input.content) {
+            memory.content = this.requireText(input.content, "content");
+        }
+        if (input.scopePath !== undefined) {
+            memory.scopePath = input.scopePath;
+        }
+        memory.tags = input.tags ?? memory.tags;
+        memory.confidence = this.normalizeConfidence(input.confidence, memory.confidence);
+        memory.status = input.status ?? memory.status;
+        memory.memoryType = input.memoryType ?? memory.memoryType;
+        memory.evidence = input.evidence ?? memory.evidence;
+        memory.updatedAt = nowIso();
+        return this.memoryRepository.update(memory);
+    }
+    ensureProject(projectId) {
+        const project = this.projectRepository.findById(projectId);
+        if (!project) {
+            throw new AppError({ statusCode: 404, errorCode: "BUTLER_PROJECT_NOT_FOUND", detail: "项目不存在" });
+        }
+        return project;
+    }
+    requireText(value, field) {
+        const normalized = value?.trim();
+        if (!normalized) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: `${field} 不能为空`,
+                field
+            });
+        }
+        return normalized;
+    }
+    normalizeConfidence(value, fallback = 0.5) {
+        if (value === undefined) {
+            return fallback;
+        }
+        if (Number.isNaN(value) || value < 0 || value > 1) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "confidence 必须在 0 到 1 之间",
+                field: "confidence"
+            });
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=project-memory-service.js.map

package/dist/server/modules/butler/project-memory-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-memory-service.js","sourceRoot":"","sources":["../../../../src/modules/butler/project-memory-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAiBpD,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,iBAA0C,EAC1C,gBAAyC;QADzC,sBAAiB,GAAjB,iBAAiB,CAAyB;QAC1C,qBAAgB,GAAhB,gBAAgB,CAAyB;IACzD,CAAC;IAEJ,YAAY,CACV,SAAiB,EACjB,OAKC;QAED,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,KAAkB;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAkB;YAC5B,EAAE,EAAE,QAAQ,EAAE;YACd,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,qBAAqB,EAAE,IAAI;YAC3B,kBAAkB,EAAE,IAAI;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,MAAM;YACtC,KAAK;YACL,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,OAAO;YACP,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;YACtB,UAAU;YACV,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,WAAW;YACnC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;YAC9B,YAAY,EAAE,IAAI;YAClB,SAAS,EAAE,MAAM,EAAE;YACnB,SAAS,EAAE,MAAM,EAAE;SACpB,CAAC;QAEF,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,QAAgB,EAAE,KAAkB;QAClE,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAExD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,QAAQ,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,kBAAkB;gBAC7B,MAAM,EAAE,aAAa;aACtB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACrC,CAAC;QAED,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;QACxC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QAClF,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;QAC9C,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;QAC1D,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC;QACpD,MAAM,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;QAE5B,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAEO,aAAa,CAAC,SAAiB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,EAAE,0BAA0B,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAClG,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,WAAW,CAAC,KAAyB,EAAE,KAAa;QAC1D,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;QAEjC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,GAAG,KAAK,OAAO;gBACvB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,mBAAmB,CAAC,KAAc,EAAE,QAAQ,GAAG,GAAG;QACxD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,yBAAyB;gBACjC,KAAK,EAAE,YAAY;aACpB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/server/modules/butler/provider-adapter-registry.d.ts

@@ -0,0 +1,61 @@
+import type { SessionHistoryService } from "../sessions/session-history-service.js";
+import type { SessionLiveRuntimeService } from "../sessions/session-live-runtime-service.js";
+export interface PatrolStructuredOutput {
+    summary: string | null;
+    riskLevel: "low" | "medium" | "high" | null;
+    suggestions: string[];
+    progressState: "unknown" | "working" | "blocked" | "done";
+    riskFlags: string[];
+    nextActions: string[];
+    rawJson: string | null;
+}
+export interface StartPatrolSessionInput {
+    workspaceId: string;
+    userId: string;
+    providerId: "codex" | "claude-code";
+    prompt: string;
+    model: string | null;
+    reasoningLevel: string | null;
+    permissionMode: string | null;
+}
+export interface PatrolSessionLaunchResult {
+    sessionId: string;
+    provider: string;
+    providerSessionId: string;
+    acceptedAt: string;
+}
+export interface PatrolSessionResult {
+    assistantMessages: string[];
+    latestAssistantMessage: string | null;
+    structured: PatrolStructuredOutput;
+}
+export interface PatrolProviderAdapter {
+    readonly providerId: "codex" | "claude-code";
+    startPatrolSession(input: StartPatrolSessionInput): Promise<PatrolSessionLaunchResult>;
+    waitForSessionTerminal(sessionId: string): Promise<void>;
+    readPatrolResult(sessionId: string): Promise<PatrolSessionResult>;
+}
+export declare class ProviderAdapterRegistry {
+    private readonly adapters;
+    constructor(adapters: PatrolProviderAdapter[]);
+    get(providerId: "codex" | "claude-code"): PatrolProviderAdapter;
+}
+interface RuntimePatrolProviderAdapterOptions {
+    waitTimeoutMs?: number;
+    waitPollIntervalMs?: number;
+}
+export declare class RuntimePatrolProviderAdapter implements PatrolProviderAdapter {
+    readonly providerId: "codex" | "claude-code";
+    private readonly sessionLiveRuntimeService;
+    private readonly sessionHistoryService;
+    private readonly waitTimeoutMs;
+    private readonly waitPollIntervalMs;
+    private readonly sessionOwnerBySessionId;
+    constructor(providerId: "codex" | "claude-code", sessionLiveRuntimeService: SessionLiveRuntimeService, sessionHistoryService: SessionHistoryService, options?: RuntimePatrolProviderAdapterOptions);
+    startPatrolSession(input: StartPatrolSessionInput): Promise<PatrolSessionLaunchResult>;
+    waitForSessionTerminal(sessionId: string): Promise<void>;
+    readPatrolResult(sessionId: string): Promise<PatrolSessionResult>;
+    private waitForTerminalWithSubscription;
+    private readRuntimeState;
+}
+export {};