Files
Agent-Workbench/src/shared/contracts/workspaces.mjs
T

58 lines
3.9 KiB
JavaScript

import fs from 'node:fs';
import path from 'node:path';
export const WORKSPACE_ACTIVE = new Set(['creating', 'verifying', 'registering']);
const conflict = message => Object.assign(new Error(message), { status: 409 });
const key = value => process.platform === 'win32' ? path.resolve(value).toLowerCase() : path.resolve(value);
const same = (a, b) => key(a) === key(b);
export function unresolvedWorkspaces(store, projectId, { exceptId = null, includePrepared = false } = {}) {
const records = [...(store.core.workspace?.values() ?? [])], project = store.project(projectId);
const commonDirs = new Set(records.filter(record => record.projectId === projectId || record.childProjectId === projectId)
.map(record => key(record.source.commonDir)));
if (project.workspace?.commonGitDir) commonDirs.add(key(project.workspace.commonGitDir));
return records.filter(record => record.id !== exceptId
&& (record.projectId === projectId || record.childProjectId === projectId || commonDirs.has(key(record.source.commonDir)))
&& (record.requiresVerification || record.status === 'unknown' || WORKSPACE_ACTIVE.has(record.status)
|| includePrepared && record.status === 'prepared'));
}
export function assertWorkspacesResolved(store, projectId, options) {
if (unresolvedWorkspaces(store, projectId, options).length) throw conflict(
'这个项目的Git隔离工作区正在准备、创建或结果待核对,请先在所属会话处理工作区记录。');
}
function controlFile(file) {
const stat = fs.lstatSync(file);
if (!stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1 || stat.size > 4096) throw conflict('隔离工作区的Git身份文件已变化,请核对原工作区。');
return fs.readFileSync(file, 'utf8').trim();
}
// A linked checkout must still be the same Git administrative directory and
// branch. This guard also applies to direct file APIs before any file mutation.
export function assertWorkspacePath(project) {
if (!project.workspace) return;
const identity = project.workspace;
if (!identity.gitDir || !identity.commonGitDir || !identity.branch) throw conflict('隔离工作区缺少已验证的Git身份。');
const root = fs.lstatSync(project.root);
if (!root.isDirectory() || root.isSymbolicLink() || !same(fs.realpathSync.native(project.root), project.root)) throw conflict('隔离工作区路径已变化,不能继续使用旧项目身份。');
if (!key(identity.gitDir).startsWith(key(path.join(identity.commonGitDir, 'worktrees')) + path.sep)
|| !same(fs.realpathSync.native(identity.gitDir), identity.gitDir)
|| !same(fs.realpathSync.native(identity.commonGitDir), identity.commonGitDir)) throw conflict('隔离工作区Git管理目录与来源不匹配。');
const gitFile = path.join(project.root, '.git'), match = controlFile(gitFile).match(/^gitdir: (.+)$/);
if (!match || !same(path.resolve(project.root, match[1]), identity.gitDir)
|| !same(controlFile(path.join(identity.gitDir, 'gitdir')), gitFile)
|| !same(path.resolve(identity.gitDir, controlFile(path.join(identity.gitDir, 'commondir'))), identity.commonGitDir)
|| controlFile(path.join(identity.gitDir, 'HEAD')) !== 'ref: refs/heads/' + identity.branch) throw conflict(
'隔离工作区的目录、Git登记或分支已被外部修改,请保留现场并核对后重新打开。');
}
export function projectWorkspaceIdentity(project) {
if (!project.workspace) return { kind: 'local-project', projectId: project.id, root: project.root };
const value = project.workspace;
return { kind: 'managed-worktree', projectId: project.id, root: project.root, workspaceId: value.id,
sourceProjectId: value.sourceProjectId, sourceSessionId: value.sourceSessionId, sourceRoot: value.sourceRoot,
sourceWorkspaceId: value.sourceWorkspaceId ?? null, baseCommit: value.baseCommit, branch: value.branch,
commonGitDir: value.commonGitDir, gitDir: value.gitDir, fingerprint: value.fingerprint };
}