@jingyi0605/codingns 0.1.3 → 0.1.5

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

@@ -0,0 +1,253 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AppError } from "../../shared/errors/app-error.js";
+import { createId } from "../../shared/utils/id.js";
+import { nowIso } from "../../shared/utils/time.js";
+export class ButlerProjectService {
+    butlerProjectRepository;
+    butlerSessionRepository;
+    workspaceRepository;
+    butlerProfileService;
+    constructor(butlerProjectRepository, butlerSessionRepository, workspaceRepository, butlerProfileService) {
+        this.butlerProjectRepository = butlerProjectRepository;
+        this.butlerSessionRepository = butlerSessionRepository;
+        this.workspaceRepository = workspaceRepository;
+        this.butlerProfileService = butlerProfileService;
+    }
+    list(input) {
+        this.syncManagedProjects();
+        return this.butlerProjectRepository.list(input);
+    }
+    create(input) {
+        const workspace = this.getWorkspaceOrThrow(input.workspaceId);
+        const name = requireNonEmptyText(input.name, "name", "项目名称不能为空");
+        const repoRoot = this.resolveRepoRootWithinWorkspace(workspace.path, input.repoRoot);
+        if (this.butlerProjectRepository.list({ workspaceId: workspace.id }).some((item) => item.repoRoot === repoRoot)) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "BUTLER_PROJECT_EXISTS",
+                detail: "当前工作区下已存在相同仓库路径的代码助手项目",
+                field: "repoRoot"
+            });
+        }
+        const timestamp = nowIso();
+        return this.butlerProjectRepository.create({
+            id: createId(),
+            workspaceId: workspace.id,
+            name,
+            repoRoot,
+            defaultProvider: input.defaultProvider?.trim() || null,
+            instructionProfileId: null,
+            approvalMode: input.approvalMode ?? "controlled",
+            lifecycleStatus: "active",
+            riskLevel: "low",
+            config: input.config ?? {},
+            lastPatrolAt: null,
+            lastVerificationAt: null,
+            createdAt: timestamp,
+            updatedAt: timestamp,
+            archivedAt: null
+        });
+    }
+    getById(projectId) {
+        this.syncManagedProjects();
+        const project = this.butlerProjectRepository.findById(projectId);
+        if (!project) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "BUTLER_PROJECT_NOT_FOUND",
+                detail: "代码助手项目不存在"
+            });
+        }
+        return project;
+    }
+    resolveWorkspaceActionProject(workspaceId) {
+        this.syncManagedProjects();
+        const projects = this.butlerProjectRepository.list({ workspaceId });
+        const activeProjects = projects.filter((project) => project.lifecycleStatus === "active");
+        const preferredProject = activeProjects.find(isWorkspaceAutoManagedProject)
+            ?? activeProjects[0]
+            ?? projects.find(isWorkspaceAutoManagedProject)
+            ?? projects[0]
+            ?? null;
+        if (!preferredProject) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "BUTLER_PROJECT_NOT_FOUND",
+                detail: "当前工作区还没有可用的代码助手项目"
+            });
+        }
+        return preferredProject;
+    }
+    update(projectId, input) {
+        const current = this.getById(projectId);
+        const nextLifecycleStatus = input.lifecycleStatus ?? current.lifecycleStatus;
+        const nextArchivedAt = nextLifecycleStatus === "archived" ? current.archivedAt ?? nowIso() : null;
+        const updated = this.butlerProjectRepository.update({
+            ...current,
+            name: input.name?.trim() || current.name,
+            defaultProvider: input.defaultProvider === undefined
+                ? current.defaultProvider
+                : input.defaultProvider?.trim() || null,
+            approvalMode: input.approvalMode ?? current.approvalMode,
+            lifecycleStatus: nextLifecycleStatus,
+            riskLevel: input.riskLevel ?? current.riskLevel,
+            config: input.config ?? current.config,
+            archivedAt: nextArchivedAt,
+            updatedAt: nowIso()
+        });
+        if (!updated) {
+            throw new AppError({
+                statusCode: 500,
+                errorCode: "BUTLER_PROJECT_UPDATE_FAILED",
+                detail: "代码助手项目更新失败"
+            });
+        }
+        return updated;
+    }
+    getOverview(projectId) {
+        this.syncManagedProjects();
+        const project = this.getById(projectId);
+        const sessions = this.butlerSessionRepository.listByProject(project.id);
+        return {
+            project,
+            activeSessionCount: sessions.filter((session) => session.status === "running").length,
+            latestPatrolRun: null,
+            latestVerificationRun: null,
+            topRisks: [],
+            nextSuggestions: []
+        };
+    }
+    getWorkspaceOrThrow(workspaceId) {
+        const workspace = this.workspaceRepository.findById(workspaceId);
+        if (!workspace || workspace.removedAt) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "WORKSPACE_NOT_FOUND",
+                detail: "工作区不存在"
+            });
+        }
+        return workspace;
+    }
+    syncManagedProjects() {
+        const profile = this.butlerProfileService?.getProfile() ?? null;
+        const butlerWorkspacePath = profile?.workspacePath ? path.resolve(profile.workspacePath) : null;
+        const activeWorkspaces = this.workspaceRepository.list().filter((workspace) => {
+            if (!butlerWorkspacePath) {
+                return true;
+            }
+            return !isPathInsideButlerWorkspace(workspace.path, butlerWorkspacePath);
+        });
+        const activeWorkspaceIds = new Set(activeWorkspaces.map((workspace) => workspace.id));
+        const projects = this.butlerProjectRepository.list();
+        for (const workspace of activeWorkspaces) {
+            const normalizedWorkspacePath = path.resolve(workspace.path);
+            if (butlerWorkspacePath && isPathInsideButlerWorkspace(normalizedWorkspacePath, butlerWorkspacePath)) {
+                continue;
+            }
+            const sameWorkspaceProjects = projects.filter((project) => project.workspaceId === workspace.id);
+            const autoProject = sameWorkspaceProjects.find(isWorkspaceAutoManagedProject) ?? null;
+            if (sameWorkspaceProjects.length === 0) {
+                const timestamp = nowIso();
+                this.butlerProjectRepository.create({
+                    id: createId(),
+                    workspaceId: workspace.id,
+                    name: workspace.name,
+                    repoRoot: workspace.repoRoot ?? workspace.path,
+                    defaultProvider: null,
+                    instructionProfileId: null,
+                    approvalMode: "controlled",
+                    lifecycleStatus: "active",
+                    riskLevel: "low",
+                    config: {
+                        managedBy: "workspace-auto"
+                    },
+                    lastPatrolAt: null,
+                    lastVerificationAt: null,
+                    createdAt: timestamp,
+                    updatedAt: timestamp,
+                    archivedAt: null
+                });
+                continue;
+            }
+            if (!autoProject) {
+                continue;
+            }
+            const nextRepoRoot = workspace.repoRoot ?? workspace.path;
+            const shouldRestore = autoProject.lifecycleStatus !== "active" || autoProject.archivedAt !== null;
+            const shouldRefreshMeta = autoProject.name !== workspace.name || autoProject.repoRoot !== nextRepoRoot;
+            if (!shouldRestore && !shouldRefreshMeta) {
+                continue;
+            }
+            this.butlerProjectRepository.update({
+                ...autoProject,
+                name: workspace.name,
+                repoRoot: nextRepoRoot,
+                lifecycleStatus: "active",
+                archivedAt: null,
+                updatedAt: nowIso()
+            });
+        }
+        for (const project of projects) {
+            if (!isWorkspaceAutoManagedProject(project)) {
+                continue;
+            }
+            if (activeWorkspaceIds.has(project.workspaceId)) {
+                continue;
+            }
+            if (project.lifecycleStatus === "archived") {
+                continue;
+            }
+            this.butlerProjectRepository.update({
+                ...project,
+                lifecycleStatus: "archived",
+                archivedAt: project.archivedAt ?? nowIso(),
+                updatedAt: nowIso()
+            });
+        }
+    }
+    resolveRepoRootWithinWorkspace(workspacePath, repoRoot) {
+        const normalized = requireNonEmptyText(repoRoot, "repoRoot", "仓库路径不能为空");
+        const resolvedRepoRoot = path.resolve(normalized);
+        if (!fs.existsSync(resolvedRepoRoot) || !fs.statSync(resolvedRepoRoot).isDirectory()) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "仓库路径必须是已存在的目录",
+                field: "repoRoot"
+            });
+        }
+        const relative = path.relative(path.resolve(workspacePath), resolvedRepoRoot);
+        const isInsideWorkspace = relative === ""
+            || (!relative.startsWith("..") && !path.isAbsolute(relative));
+        if (!isInsideWorkspace) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "仓库路径必须位于工作区边界内",
+                field: "repoRoot"
+            });
+        }
+        return resolvedRepoRoot;
+    }
+}
+function isWorkspaceAutoManagedProject(project) {
+    return project.config.managedBy === "workspace-auto";
+}
+function isPathInsideButlerWorkspace(candidatePath, butlerWorkspacePath) {
+    const relative = path.relative(path.resolve(butlerWorkspacePath), path.resolve(candidatePath));
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function requireNonEmptyText(value, field, detail) {
+    const normalized = value?.trim();
+    if (!normalized) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail,
+            field
+        });
+    }
+    return normalized;
+}
+//# sourceMappingURL=butler-project-service.js.map

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

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

package/dist/server/modules/butler/butler-session-service.d.ts

@@ -0,0 +1,79 @@
+import type { ButlerSessionOwnershipMode, ButlerSessionRole, ButlerSessionStatus, SessionRunningState } from "../../types/domain.js";
+import type { ButlerProjectRepository } from "../../storage/repositories/butler-project-repository.js";
+import type { ButlerSessionRepository } from "../../storage/repositories/butler-session-repository.js";
+import type { SessionBindingRepository } from "../../storage/repositories/session-binding-repository.js";
+import type { SessionCheckpointRepository } from "../../storage/repositories/session-checkpoint-repository.js";
+import type { SessionIndexRepository } from "../../storage/repositories/session-index-repository.js";
+import type { SessionStateRepository } from "../../storage/repositories/session-state-repository.js";
+import type { SessionLiveRuntimeService } from "../sessions/session-live-runtime-service.js";
+import type { SessionHistoryService } from "../sessions/session-history-service.js";
+export interface ButlerProjectSessionView {
+    id: string;
+    projectId: string;
+    sessionId: string;
+    provider: string | null;
+    title: string | null;
+    isArchived: boolean;
+    role: ButlerSessionRole;
+    ownershipMode: ButlerSessionOwnershipMode;
+    status: ButlerSessionStatus;
+    runningState: SessionRunningState | null;
+    lastSummary: string | null;
+    lastCheckpointAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ImportButlerSessionInput {
+    sessionId: string;
+    role?: ButlerSessionRole;
+    ownershipMode?: ButlerSessionOwnershipMode;
+}
+export interface CaptureButlerSessionSnapshotInput {
+    sourceKind?: "snapshot" | "manual";
+}
+export interface StartButlerSessionInput {
+    providerId?: "codex" | "claude-code";
+    role?: ButlerSessionRole;
+    ownershipMode?: ButlerSessionOwnershipMode;
+    content?: string;
+    model?: string | null;
+    reasoningLevel?: string | null;
+    permissionMode?: string | null;
+}
+export interface ResumeButlerSessionResult {
+    session: ButlerProjectSessionView;
+    resumedAt: string;
+    provider: string;
+    providerSessionId: string;
+}
+export interface ButlerSessionActionTarget {
+    workspaceId: string;
+    session: ButlerProjectSessionView;
+}
+export declare class ButlerSessionService {
+    private readonly butlerProjectRepository;
+    private readonly butlerSessionRepository;
+    private readonly sessionCheckpointRepository;
+    private readonly sessionBindingRepository;
+    private readonly sessionIndexRepository;
+    private readonly sessionStateRepository;
+    private readonly sessionLiveRuntimeService?;
+    private readonly sessionHistoryService?;
+    constructor(butlerProjectRepository: ButlerProjectRepository, butlerSessionRepository: ButlerSessionRepository, sessionCheckpointRepository: SessionCheckpointRepository, sessionBindingRepository: SessionBindingRepository, sessionIndexRepository: SessionIndexRepository, sessionStateRepository: SessionStateRepository, sessionLiveRuntimeService?: Pick<SessionLiveRuntimeService, "startLiveSession"> | undefined, sessionHistoryService?: Pick<SessionHistoryService, "discoverWorkspaceSessions" | "listWorkspaceSessions" | "resumeSession"> | undefined);
+    startSession(projectId: string, input: StartButlerSessionInput, userId: string): Promise<ButlerProjectSessionView>;
+    listByProject(projectId: string, userId: string, options?: {
+        includeArchived?: boolean;
+    }): ButlerProjectSessionView[];
+    importSession(projectId: string, input: ImportButlerSessionInput, userId: string): ButlerProjectSessionView;
+    ensureProjectSessionsSynced(projectId: string, userId: string, options?: {
+        includeArchived?: boolean;
+        force?: boolean;
+    }): Promise<void>;
+    captureSessionSnapshot(projectId: string, butlerSessionId: string, userId: string, input?: CaptureButlerSessionSnapshotInput): ButlerProjectSessionView;
+    resumeSession(projectId: string, butlerSessionId: string, userId: string): Promise<ResumeButlerSessionResult>;
+    getSessionWorkspaceId(sessionId: string): string;
+    resolveActionTarget(projectId: string, sessionId: string, userId: string): Promise<ButlerSessionActionTarget>;
+    private getProjectOrThrow;
+    private importWorkspaceSessions;
+    private createObservedSession;
+}