@jingyi0605/codingns 0.2.0 → 0.3.0

package/dist/server/modules/workspace/workspace-controller.js

@@ -1,3 +1,4 @@
+import { requireUserId } from "../preferences/common.js";
 export class WorkspaceController {
     workspaceService;
     constructor(workspaceService) {
@@ -34,5 +35,23 @@ export class WorkspaceController {
     remove = async (request, reply) => {
         reply.send(this.workspaceService.removeWorkspace(request.params.workspaceId));
     };
+    reorder = async (request, reply) => {
+        reply.send({
+            items: this.workspaceService.reorderWorkspaces(request.body.workspaceIds ?? [])
+        });
+    };
+    updateNavigationState = async (request, reply) => {
+        const input = {};
+        if (typeof request.body?.collapsed === "boolean") {
+            input.collapsed = request.body.collapsed;
+        }
+        if (request.body && Object.prototype.hasOwnProperty.call(request.body, "backgroundColor")) {
+            const rawBackgroundColor = request.body.backgroundColor;
+            if (rawBackgroundColor === null || typeof rawBackgroundColor === "string") {
+                input.backgroundColor = rawBackgroundColor;
+            }
+        }
+        reply.send(this.workspaceService.updateNavigationState(request.params.workspaceId, requireUserId(request), input));
+    };
 }
 //# sourceMappingURL=workspace-controller.js.map

package/dist/server/modules/workspace/workspace-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-controller.js","sourceRoot":"","sources":["../../../../src/modules/workspace/workspace-controller.ts"],"names":[],"mappings":"AA2CA,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,gBAAkC;QAAlC,qBAAgB,GAAhB,gBAAgB,CAAkB;IAAG,CAAC;IAE1D,IAAI,GAAG,KAAK,EAAE,QAAwB,EAAE,KAAmB,EAAiB,EAAE;QACrF,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;SACpC,CAAC,CAAC;IACL,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EACrB,OAA8D,EAC9D,KAAmB,EACJ,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC;IAEO,eAAe,GAAG,KAAK,EAC9B,OAA+D,EAC/D,KAAmB,EACJ,EAAE;QACjB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CACpB,IAAI,CAAC,gBAAgB,CAAC,eAAe,CACnC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,EACrC,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CACzC,CACF,CAAC;IACJ,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EACrB,OAAsD,EACtD,KAAmB,EACJ,EAAE;QACjB,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,eAAe,CACrD,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAC1B,CAAC;QAEF,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC;IAEO,KAAK,GAAG,KAAK,EACpB,OAAqD,EACrD,KAAmB,EACJ,EAAE;QACjB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;YAC3D,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,EAAE;YACvD,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE;YACjD,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,IAAI,SAAS;YAC9D,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,SAAS;YAC5C,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;SACxB,CAAC,CAAC;QAEH,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC,CAAC;IAEO,oBAAoB,GAAG,KAAK,EACnC,OAAoD,EACpD,KAAmB,EACJ,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EACrB,OAAoD,EACpD,KAAmB,EACJ,EAAE;QACjB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC;CACH"}
+{"version":3,"file":"workspace-controller.js","sourceRoot":"","sources":["../../../../src/modules/workspace/workspace-controller.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/workspace/workspace-service.d.ts

@@ -1,6 +1,11 @@
+import type { WorkspaceNavigationStateRepository } from "../../storage/repositories/workspace-navigation-state-repository.js";
 import type { WorkspaceRepository } from "../../storage/repositories/workspace-repository.js";
-import type { Workspace } from "../../types/domain.js";
+import type { WorkspaceWorktreeRepository } from "../../storage/repositories/workspace-worktree-repository.js";
+import type { Workspace, WorkspaceNavigationStateRecord } from "../../types/domain.js";
+import type { ButlerProfileService } from "../butler/butler-profile-service.js";
+import { type GitAuthInput } from "../git/git-auth.js";
 import type { GitCommandRunner } from "../git/git-command-runner.js";
+import { type TaskManager } from "../tasks/task-manager.js";
 interface WorkspaceDirectoryOption {
     path: string;
     name: string;
@@ -15,23 +20,12 @@ export interface WorkspaceCreatedDirectoryResult {
     path: string;
     name: string;
 }
-type WorkspaceCloneAuth = {
-    mode?: "none";
-} | {
-    mode: "basic";
-    username?: string;
-    password?: string;
-} | {
-    mode: "token";
-    username?: string;
-    token?: string;
-};
 export interface CloneWorkspaceInput {
     repositoryUrl: string;
     parentPath: string;
     directoryName?: string;
     name?: string;
-    auth?: WorkspaceCloneAuth | null;
+    auth?: GitAuthInput | null;
 }
 interface WorkspaceGitRemoteSummary {
     name: string;
@@ -63,19 +57,32 @@ export interface WorkspaceManagementSummary {
     git: WorkspaceGitSummary;
     codeComposition: WorkspaceCodeCompositionSummary;
 }
+export interface UpdateWorkspaceNavigationStateInput {
+    collapsed?: boolean;
+    backgroundColor?: string | null;
+}
 export declare class WorkspaceService {
     private readonly workspaceRepository;
     private readonly gitCommandRunner;
-    constructor(workspaceRepository: WorkspaceRepository, gitCommandRunner: GitCommandRunner);
+    private readonly workspaceNavigationStateRepository;
+    private readonly butlerProfileService?;
+    private readonly workspaceWorktreeRepository?;
+    private readonly taskManager;
+    constructor(workspaceRepository: WorkspaceRepository, gitCommandRunner: GitCommandRunner, workspaceNavigationStateRepository: WorkspaceNavigationStateRepository, butlerProfileService?: Pick<ButlerProfileService, "getProfile"> | undefined, workspaceWorktreeRepository?: Pick<WorkspaceWorktreeRepository, "listWorkspaceIds"> | undefined, taskManager?: TaskManager);
     browseDirectories(requestedPath?: string): WorkspaceDirectoryBrowseResult;
     createDirectory(parentPath: string, directoryName: string): WorkspaceCreatedDirectoryResult;
     importWorkspace(workspacePath: string, name?: string): Workspace;
     cloneWorkspace(input: CloneWorkspaceInput): Promise<Workspace>;
     list(): Workspace[];
+    reorderWorkspaces(workspaceIds: string[]): Workspace[];
     removeWorkspace(workspaceId: string): Workspace;
     getManagementSummary(workspaceId: string): Promise<WorkspaceManagementSummary>;
     getWorkspaceOrThrow(workspaceId: string): Workspace;
     findWorkspaceByPath(workspacePath: string): Workspace | null;
+    updateNavigationState(workspaceId: string, userId: string, input: UpdateWorkspaceNavigationStateInput): WorkspaceNavigationStateRecord;
+    private listVisibleWorkspaces;
     private readGitSummary;
+    private registerBackgroundTasks;
+    private loadManagementSummary;
 }
 export {};

package/dist/server/modules/workspace/workspace-service.js

@@ -4,87 +4,27 @@ import path from "node:path";
 import { AppError, isAppError } from "../../shared/errors/app-error.js";
 import { createId } from "../../shared/utils/id.js";
 import { nowIso } from "../../shared/utils/time.js";
+import { createGitAuthContext } from "../git/git-auth.js";
+import { createTaskManager } from "../tasks/task-manager.js";
+import { HOST_TASK_TYPES } from "../tasks/task-types.js";
+import { readWorkspaceCodeComposition } from "./workspace-code-composition.js";
 const DIRECTORY_BROWSE_LIMIT = 200;
 const GIT_CLONE_TIMEOUT_MS = 120_000;
-const WORKSPACE_CODE_SCAN_LIMIT = 20_000;
-const IGNORED_COMPOSITION_DIRECTORIES = new Set([
-    ".git",
-    ".idea",
-    ".vscode",
-    ".yarn",
-    ".pnpm-store",
-    ".turbo",
-    "node_modules",
-    "dist",
-    "build",
-    "coverage",
-    ".next",
-    ".nuxt",
-    "out",
-    "target",
-    "vendor",
-    "bin",
-    "obj"
-]);
-const COMPOSITION_TYPE_BY_NAME = {
-    dockerfile: "Dockerfile",
-    makefile: "Makefile",
-    justfile: "Justfile"
-};
-const COMPOSITION_TYPE_BY_EXTENSION = {
-    ".ts": "TypeScript",
-    ".tsx": "TypeScript",
-    ".mts": "TypeScript",
-    ".cts": "TypeScript",
-    ".js": "JavaScript",
-    ".jsx": "JavaScript",
-    ".mjs": "JavaScript",
-    ".cjs": "JavaScript",
-    ".vue": "Vue",
-    ".svelte": "Svelte",
-    ".css": "CSS",
-    ".scss": "SCSS",
-    ".sass": "Sass",
-    ".less": "Less",
-    ".html": "HTML",
-    ".xml": "XML",
-    ".json": "JSON",
-    ".jsonc": "JSON",
-    ".yaml": "YAML",
-    ".yml": "YAML",
-    ".toml": "TOML",
-    ".md": "Markdown",
-    ".mdx": "Markdown",
-    ".sh": "Shell",
-    ".bash": "Shell",
-    ".zsh": "Shell",
-    ".ps1": "PowerShell",
-    ".bat": "Batch",
-    ".cmd": "Batch",
-    ".py": "Python",
-    ".go": "Go",
-    ".rs": "Rust",
-    ".java": "Java",
-    ".kt": "Kotlin",
-    ".kts": "Kotlin",
-    ".swift": "Swift",
-    ".php": "PHP",
-    ".rb": "Ruby",
-    ".sql": "SQL",
-    ".c": "C",
-    ".h": "C/C++ Header",
-    ".cc": "C++",
-    ".cpp": "C++",
-    ".cxx": "C++",
-    ".hpp": "C++ Header",
-    ".cs": "C#"
-};
 export class WorkspaceService {
     workspaceRepository;
     gitCommandRunner;
-    constructor(workspaceRepository, gitCommandRunner) {
+    workspaceNavigationStateRepository;
+    butlerProfileService;
+    workspaceWorktreeRepository;
+    taskManager;
+    constructor(workspaceRepository, gitCommandRunner, workspaceNavigationStateRepository, butlerProfileService, workspaceWorktreeRepository, taskManager = createTaskManager()) {
         this.workspaceRepository = workspaceRepository;
         this.gitCommandRunner = gitCommandRunner;
+        this.workspaceNavigationStateRepository = workspaceNavigationStateRepository;
+        this.butlerProfileService = butlerProfileService;
+        this.workspaceWorktreeRepository = workspaceWorktreeRepository;
+        this.taskManager = taskManager;
+        this.registerBackgroundTasks();
     }
     browseDirectories(requestedPath) {
         const roots = listDirectoryRoots();
@@ -184,7 +124,40 @@ export class WorkspaceService {
         }
     }
     list() {
-        return this.workspaceRepository.list();
+        return this.listVisibleWorkspaces();
+    }
+    reorderWorkspaces(workspaceIds) {
+        const normalizedWorkspaceIds = normalizeWorkspaceIds(workspaceIds);
+        const visibleWorkspaces = this.listVisibleWorkspaces();
+        if (normalizedWorkspaceIds.length !== visibleWorkspaces.length) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "工作区重排必须提交当前全部可见工作区",
+                field: "workspaceIds"
+            });
+        }
+        const visibleWorkspaceIdSet = new Set(visibleWorkspaces.map((workspace) => workspace.id));
+        if (visibleWorkspaceIdSet.size !== normalizedWorkspaceIds.length) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "工作区列表包含重复项或数量异常",
+                field: "workspaceIds"
+            });
+        }
+        for (const workspaceId of normalizedWorkspaceIds) {
+            if (!visibleWorkspaceIdSet.has(workspaceId)) {
+                throw new AppError({
+                    statusCode: 400,
+                    errorCode: "INVALID_INPUT",
+                    detail: "工作区重排列表包含未知项目",
+                    field: "workspaceIds"
+                });
+            }
+        }
+        this.workspaceRepository.reorderVisible(normalizedWorkspaceIds);
+        return this.listVisibleWorkspaces();
     }
     removeWorkspace(workspaceId) {
         const workspace = this.getWorkspaceOrThrow(workspaceId);
@@ -196,18 +169,13 @@ export class WorkspaceService {
         });
     }
     async getManagementSummary(workspaceId) {
-        const workspace = this.getWorkspaceOrThrow(workspaceId);
-        const [git, codeComposition] = await Promise.all([
-            this.readGitSummary(workspace),
-            Promise.resolve(readWorkspaceCodeComposition(workspace.path))
-        ]);
-        return {
-            workspaceId: workspace.id,
-            name: workspace.name,
-            path: workspace.path,
-            git,
-            codeComposition
-        };
+        return await this.taskManager.enqueue(HOST_TASK_TYPES.workspaceManagementSummary, {
+            key: workspaceId,
+            source: "workspace.get_management_summary",
+            input: {
+                workspaceId
+            }
+        }).promise;
     }
     getWorkspaceOrThrow(workspaceId) {
         const workspace = this.workspaceRepository.findById(workspaceId);
@@ -223,6 +191,41 @@ export class WorkspaceService {
     findWorkspaceByPath(workspacePath) {
         return this.workspaceRepository.findByPath(path.resolve(workspacePath));
     }
+    updateNavigationState(workspaceId, userId, input) {
+        this.getWorkspaceOrThrow(workspaceId);
+        if (input.collapsed === undefined && input.backgroundColor === undefined) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "至少要更新一个导航状态字段"
+            });
+        }
+        const normalizedBackgroundColor = normalizeWorkspaceNavigationBackgroundColor(input.backgroundColor);
+        const existing = this.workspaceNavigationStateRepository.findByWorkspaceIdAndUserId(workspaceId, userId);
+        const timestamp = nowIso();
+        return this.workspaceNavigationStateRepository.upsert({
+            workspaceId,
+            userId,
+            collapsed: input.collapsed ?? existing?.collapsed ?? false,
+            backgroundColor: normalizedBackgroundColor !== undefined
+                ? normalizedBackgroundColor
+                : existing?.backgroundColor ?? null,
+            updatedAt: timestamp
+        });
+    }
+    listVisibleWorkspaces() {
+        const childWorkspaceIdSet = new Set(this.workspaceWorktreeRepository?.listWorkspaceIds() ?? []);
+        const butlerWorkspacePath = this.butlerProfileService?.getProfile()?.workspacePath ?? null;
+        if (!butlerWorkspacePath) {
+            return this.workspaceRepository
+                .list()
+                .filter((workspace) => !childWorkspaceIdSet.has(workspace.id));
+        }
+        return this.workspaceRepository
+            .list()
+            .filter((workspace) => !childWorkspaceIdSet.has(workspace.id))
+            .filter((workspace) => !isPathInsideButlerWorkspace(workspace.path, butlerWorkspacePath));
+    }
     async readGitSummary(workspace) {
         const workspacePath = path.resolve(workspace.path);
         if (!fs.existsSync(workspacePath) || !fs.statSync(workspacePath).isDirectory()) {
@@ -299,6 +302,64 @@ export class WorkspaceService {
             };
         }
     }
+    registerBackgroundTasks() {
+        if (!this.taskManager.has(HOST_TASK_TYPES.workspaceCodeCompositionScan)) {
+            this.taskManager.register({
+                taskType: HOST_TASK_TYPES.workspaceCodeCompositionScan,
+                executionLane: "helper_process",
+                helperProcessHandler: "workspace.code_composition_scan",
+                run: async ({ workspacePath }) => readWorkspaceCodeComposition(workspacePath)
+            });
+        }
+        if (!this.taskManager.has(HOST_TASK_TYPES.workspaceManagementSummary)) {
+            this.taskManager.register({
+                taskType: HOST_TASK_TYPES.workspaceManagementSummary,
+                executionLane: "host_background",
+                run: async ({ workspaceId }) => this.loadManagementSummary(workspaceId)
+            });
+        }
+    }
+    async loadManagementSummary(workspaceId) {
+        const workspace = this.getWorkspaceOrThrow(workspaceId);
+        const [git, codeComposition] = await Promise.all([
+            this.readGitSummary(workspace),
+            this.taskManager.enqueue(HOST_TASK_TYPES.workspaceCodeCompositionScan, {
+                key: workspace.id,
+                source: "workspace.load_management_summary.code_composition",
+                input: {
+                    workspacePath: workspace.path
+                }
+            }).promise
+        ]);
+        return {
+            workspaceId: workspace.id,
+            name: workspace.name,
+            path: workspace.path,
+            git,
+            codeComposition
+        };
+    }
+}
+function normalizeWorkspaceNavigationBackgroundColor(backgroundColor) {
+    if (backgroundColor === undefined) {
+        return undefined;
+    }
+    if (backgroundColor === null) {
+        return null;
+    }
+    const normalizedColor = backgroundColor.trim().toUpperCase();
+    if (!normalizedColor) {
+        return null;
+    }
+    if (!/^#[0-9A-F]{6}$/.test(normalizedColor)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "背景颜色必须是 #RRGGBB 格式",
+            field: "backgroundColor"
+        });
+    }
+    return normalizedColor;
 }
 function createWorkspaceRecord(workspaceRepository, workspacePath, name) {
     const existing = workspaceRepository.findByPath(workspacePath);
@@ -326,11 +387,43 @@ function createWorkspaceRecord(workspaceRepository, workspacePath, name) {
         path: workspacePath,
         repoRoot: workspacePath,
         favorite: false,
+        sortOrder: workspaceRepository.getNextSortOrder(),
         createdAt: timestamp,
         updatedAt: timestamp,
         removedAt: null
     });
 }
+function normalizeWorkspaceIds(workspaceIds) {
+    if (!Array.isArray(workspaceIds)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "workspaceIds 必须是数组",
+            field: "workspaceIds"
+        });
+    }
+    const normalizedIds = workspaceIds.map((workspaceId, index) => {
+        if (typeof workspaceId !== "string" || !workspaceId.trim()) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "workspaceIds 里的每一项都必须是非空字符串",
+                field: `workspaceIds.${index}`
+            });
+        }
+        return workspaceId.trim();
+    });
+    const uniqueIds = new Set(normalizedIds);
+    if (uniqueIds.size !== normalizedIds.length) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "workspaceIds 不允许重复",
+            field: "workspaceIds"
+        });
+    }
+    return normalizedIds;
+}
 function ensureExistingDirectory(targetPath, field) {
     if (!fs.existsSync(targetPath)) {
         throw new AppError({
@@ -384,75 +477,9 @@ function normalizeSingleDirectoryName(rawValue, field) {
     }
     return normalized;
 }
-function createGitAuthContext(auth) {
-    if (!auth || !auth.mode || auth.mode === "none") {
-        return null;
-    }
-    const mode = auth.mode;
-    let username = "";
-    let secret = "";
-    if (auth.mode === "basic") {
-        username = auth.username?.trim() || "";
-        secret = auth.password?.trim() || "";
-    }
-    else if (auth.mode === "token") {
-        username = auth.username?.trim() || "git";
-        secret = auth.token?.trim() || "";
-    }
-    else {
-        return null;
-    }
-    if (!username) {
-        throw new AppError({
-            statusCode: 400,
-            errorCode: "INVALID_INPUT",
-            detail: "Git 用户名不能为空",
-            field: "username"
-        });
-    }
-    if (!secret) {
-        throw new AppError({
-            statusCode: 400,
-            errorCode: "INVALID_INPUT",
-            detail: mode === "basic" ? "Git 密码不能为空" : "Git token 不能为空",
-            field: mode === "basic" ? "password" : "token"
-        });
-    }
-    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "codingns-git-auth-"));
-    const helperRuntimePath = path.join(tempDir, "askpass.cjs");
-    const helperScriptPath = path.join(tempDir, process.platform === "win32" ? "askpass.cmd" : "askpass.sh");
-    fs.writeFileSync(helperRuntimePath, [
-        'const prompt = (process.argv.slice(2).join(" ") || "").toLowerCase();',
-        'const username = process.env.CODINGNS_GIT_AUTH_USERNAME || "";',
-        'const secret = process.env.CODINGNS_GIT_AUTH_SECRET || "";',
-        'if (prompt.includes("username")) {',
-        "  process.stdout.write(username);",
-        '} else if (prompt.includes("password") || prompt.includes("passphrase")) {',
-        "  process.stdout.write(secret);",
-        "} else {",
-        "  process.stdout.write(secret || username);",
-        "}"
-    ].join("\n"), "utf8");
-    if (process.platform === "win32") {
-        fs.writeFileSync(helperScriptPath, '@echo off\r\n"%CODINGNS_GIT_NODE%" "%~dp0askpass.cjs" %*\r\n', "utf8");
-    }
-    else {
-        fs.writeFileSync(helperScriptPath, '#!/bin/sh\n"$CODINGNS_GIT_NODE" "$(dirname "$0")/askpass.cjs" "$@"\n', "utf8");
-        fs.chmodSync(helperScriptPath, 0o755);
-    }
-    return {
-        env: {
-            CODINGNS_GIT_NODE: process.execPath,
-            CODINGNS_GIT_AUTH_USERNAME: username,
-            CODINGNS_GIT_AUTH_SECRET: secret,
-            GIT_ASKPASS: helperScriptPath,
-            GIT_TERMINAL_PROMPT: "0",
-            GCM_INTERACTIVE: "Never"
-        },
-        cleanup: () => {
-            fs.rmSync(tempDir, { recursive: true, force: true });
-        }
-    };
+function isPathInsideButlerWorkspace(candidatePath, butlerWorkspacePath) {
+    const relative = path.relative(path.resolve(butlerWorkspacePath), path.resolve(candidatePath));
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
 }
 function mapCloneError(error) {
     if (isAppError(error)) {
@@ -546,84 +573,6 @@ function resolveParentPath(currentPath) {
     }
     return parentPath;
 }
-function readWorkspaceCodeComposition(workspacePath) {
-    const resolvedPath = path.resolve(workspacePath);
-    if (!fs.existsSync(resolvedPath) || !fs.statSync(resolvedPath).isDirectory()) {
-        return {
-            scannedFileCount: 0,
-            truncated: false,
-            items: [],
-            error: "工作区路径不存在，无法统计代码类型"
-        };
-    }
-    const typeCounts = new Map();
-    const directories = [resolvedPath];
-    let scannedFileCount = 0;
-    let truncated = false;
-    // 这里故意只做轻量扫描，避免为了一个信息面板把大仓库整棵树扫爆。
-    while (directories.length > 0 && !truncated) {
-        const currentDirectory = directories.pop();
-        if (!currentDirectory) {
-            continue;
-        }
-        let entries;
-        try {
-            entries = fs.readdirSync(currentDirectory, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            if (entry.isSymbolicLink()) {
-                continue;
-            }
-            const fullPath = path.join(currentDirectory, entry.name);
-            if (entry.isDirectory()) {
-                if (!IGNORED_COMPOSITION_DIRECTORIES.has(entry.name)) {
-                    directories.push(fullPath);
-                }
-                continue;
-            }
-            if (!entry.isFile()) {
-                continue;
-            }
-            const detectedType = detectWorkspaceFileType(entry.name);
-            if (!detectedType) {
-                continue;
-            }
-            scannedFileCount += 1;
-            typeCounts.set(detectedType, (typeCounts.get(detectedType) ?? 0) + 1);
-            if (scannedFileCount >= WORKSPACE_CODE_SCAN_LIMIT) {
-                truncated = true;
-                break;
-            }
-        }
-    }
-    const items = [...typeCounts.entries()]
-        .sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0]))
-        .map(([type, count]) => ({
-        type,
-        count,
-        ratio: scannedFileCount > 0 ? count / scannedFileCount : 0
-    }));
-    return {
-        scannedFileCount,
-        truncated,
-        items,
-        error: null
-    };
-}
-function detectWorkspaceFileType(fileName) {
-    const normalizedName = fileName.trim().toLowerCase();
-    if (!normalizedName) {
-        return null;
-    }
-    const directMatch = COMPOSITION_TYPE_BY_NAME[normalizedName];
-    if (directMatch) {
-        return directMatch;
-    }
-    return COMPOSITION_TYPE_BY_EXTENSION[path.extname(normalizedName)] ?? null;
-}
 function normalizeGitOutput(value) {
     const normalized = value.trim();
     return normalized || null;