@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/services/workspaceRegistry/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["path","fs","crypto"],"sources":["../../../../src/services/workspaceRegistry/index.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst REGISTRY_FILE = 'workspaces.json';\nconst GIT_DIRECTORY = '.git';\nconst COMMON_DIRECTORY_FILE = 'commondir';\n\nfunction canonicalPath(target: string): string {\n  const absolute = path.resolve(target);\n  try {\n    return fs.realpathSync.native(absolute);\n  } catch {\n    const parent = path.dirname(absolute);\n    if (parent === absolute) return absolute;\n    return path.join(canonicalPath(parent), path.basename(absolute));\n  }\n}\n\nfunction readGitDirectory(repositoryRoot: string): string | undefined {\n  const gitPath = path.join(repositoryRoot, GIT_DIRECTORY);\n  try {\n    const stat = fs.statSync(gitPath);\n    if (stat.isDirectory()) return canonicalPath(gitPath);\n    if (!stat.isFile()) return undefined;\n    const match = /^gitdir:\\s*(.+)$/imu.exec(fs.readFileSync(gitPath, 'utf8').trim());\n    return match?.[1] ? canonicalPath(path.resolve(repositoryRoot, match[1].trim())) : undefined;\n  } catch {\n    // Not a git checkout, or one this process cannot read: it has no git data to share.\n    return undefined;\n  }\n}\n\n/** The git data directory shared by every worktree of a repository, if the root is a git checkout. */\nexport function gitCommonDirectory(repositoryRoot: string): string | undefined {\n  const gitDirectory = readGitDirectory(repositoryRoot);\n  if (!gitDirectory) return undefined;\n  try {\n    const relative = fs.readFileSync(path.join(gitDirectory, COMMON_DIRECTORY_FILE), 'utf8').trim();\n    return relative ? canonicalPath(path.resolve(gitDirectory, relative)) : gitDirectory;\n  } catch {\n    // A plain checkout has no commondir file; its own git directory is the common one.\n    return gitDirectory;\n  }\n}\n/** Kept in the repository's git data, which moves with the checkout and is shared by its worktrees. */\nconst WORKSPACE_MARKER_FILE = 'po-workspace-id';\nconst DIRECTORY_MODE = 0o700;\nconst FILE_MODE = 0o600;\n\nexport interface WorkspaceRecord {\n  id: string;\n  root: string;\n  /** Display name chosen when the workspace was added; the folder basename stands in when absent. */\n  name?: string;\n}\n\nexport interface WorkspaceRegistry {\n  list(): readonly WorkspaceRecord[];\n  add(record: WorkspaceRecord): void;\n  remove(id: string): void;\n}\n\nexport interface WorkspaceRegistryOptions {\n  directory: string;\n  onNotice?: (message: string) => void;\n}\n\nfunction parseRecord(value: unknown): WorkspaceRecord | undefined {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.id !== 'string' || record.id === '') return undefined;\n  if (typeof record.root !== 'string' || !path.isAbsolute(record.root)) return undefined;\n  const name = typeof record.name === 'string' && record.name.trim() !== '' ? record.name : undefined;\n  return { id: record.id, root: record.root, ...(name === undefined ? {} : { name }) };\n}\n\n/** Durable workspace membership, independent of whether a workspace can currently mount. */\nexport function createWorkspaceRegistry(options: WorkspaceRegistryOptions): WorkspaceRegistry {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n\n  const load = (): WorkspaceRecord[] => {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return [];\n      notice(`${filePath} could not be read: ${error instanceof Error ? error.message : String(error)}`);\n      return [];\n    }\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      notice(`workspaces at ${filePath} are not valid JSON; none will be restored`);\n      return [];\n    }\n    if (!Array.isArray(parsed)) {\n      notice(`workspaces at ${filePath} are not a list; none will be restored`);\n      return [];\n    }\n    const records: WorkspaceRecord[] = [];\n    for (const entry of parsed) {\n      const record = parseRecord(entry);\n      if (record === undefined) notice(`workspaces at ${filePath} contain an unusable entry; skipping it`);\n      else if (!records.some((candidate) => candidate.id === record.id)) records.push(record);\n    }\n    return records;\n  };\n\n  let current = load();\n\n  const persist = (next: readonly WorkspaceRecord[]): void => {\n    const temporary = `${filePath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.directory, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, `${JSON.stringify(next, undefined, 2)}\\n`, { mode: FILE_MODE });\n      fs.renameSync(temporary, filePath);\n    } catch (error) {\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch (cleanupError) {\n        notice(\n          `${temporary} could not be removed: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`,\n        );\n      }\n      throw new Error(`${filePath} could not be saved`, { cause: error });\n    }\n  };\n\n  return {\n    list: () => current,\n    // Each write starts from the file, not from memory: another process (a sync, a second\n    // server) may have changed it since this one last read, and its entries must survive.\n    add(record) {\n      if (record.id === '' || !path.isAbsolute(record.root)) throw new Error('Invalid workspace record.');\n      const latest = load();\n      // Replaced in place: registry order is the tie-break when checkouts are matched to workspaces.\n      const next = latest.some((held) => held.id === record.id)\n        ? latest.map((held) => (held.id === record.id ? record : held))\n        : [...latest, record];\n      persist(next);\n      current = next;\n    },\n    remove(id) {\n      const latest = load();\n      const next = latest.filter((held) => held.id !== id);\n      if (next.length !== latest.length) persist(next);\n      current = next;\n    },\n  };\n}\n\n/** The workspace id recorded in a checkout's git data, if any. */\nexport function readWorkspaceMarker(checkoutRoot: string): string | undefined {\n  const commonDirectory = gitCommonDirectory(checkoutRoot);\n  if (commonDirectory === undefined) return undefined;\n  try {\n    const id = fs.readFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), 'utf8').trim();\n    return id === '' ? undefined : id;\n  } catch (error) {\n    if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/**\n * Records a workspace id in a checkout's git data so the workspace keeps its id when the\n * repository moves. A checkout without git data has nowhere to keep it; returns false.\n */\nexport function writeWorkspaceMarker(checkoutRoot: string, id: string): boolean {\n  const commonDirectory = gitCommonDirectory(checkoutRoot);\n  if (commonDirectory === undefined) return false;\n  fs.writeFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), `${id}\\n`, { mode: FILE_MODE });\n  return true;\n}\n\nexport interface WorkspaceIdentity {\n  readonly id: string;\n  /** The workspace root. Differs from the checkout when the checkout joins an existing workspace. */\n  readonly root: string;\n  /** The recorded root no longer exists and this checkout takes its place. */\n  readonly moved: boolean;\n}\n\n/**\n * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id\n * in the repository's git data names the workspace: a checkout of a workspace whose root still\n * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else\n * is a new workspace.\n */\nexport function identifyWorkspace(input: {\n  readonly records: readonly WorkspaceRecord[];\n  readonly checkoutRoot: string;\n  readonly marker?: string;\n  readonly exists?: (root: string) => boolean;\n  readonly newId?: () => string;\n}): WorkspaceIdentity {\n  const exact = input.records.find((record) => record.root === input.checkoutRoot);\n  if (exact !== undefined) return { id: exact.id, root: exact.root, moved: false };\n  const owner = input.marker === undefined ? undefined : input.records.find((record) => record.id === input.marker);\n  if (owner !== undefined) {\n    const exists = input.exists ?? fs.existsSync;\n    return exists(owner.root)\n      ? { id: owner.id, root: owner.root, moved: false }\n      : { id: owner.id, root: input.checkoutRoot, moved: true };\n  }\n  return { id: input.marker ?? (input.newId ?? crypto.randomUUID)(), root: input.checkoutRoot, moved: false };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["createSerialRunner"],"sources":["../../../../src/services/workspaceRegistry/index.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\n\nimport { nodeHost } from '../nodeHost';\nimport { readTextIfExists, writeFileAtomic } from '../platformFiles';\nimport { createSerialRunner } from '../serialRunner';\nimport {\n  assertWorkspaceRecord,\n  COMMON_DIRECTORY_FILE,\n  DIRECTORY_MODE,\n  FILE_MODE,\n  GIT_DIRECTORY,\n  gitFileTarget,\n  matchWorkspace,\n  parseWorkspaceMarker,\n  parseWorkspaceRecords,\n  REGISTRY_FILE,\n  resolveWorkspaceIdentity,\n  serializeWorkspaceRecords,\n  withWorkspaceRecord,\n  WORKSPACE_MARKER_FILE,\n  type WorkspaceIdentity,\n  type WorkspaceIdentityInput,\n  type WorkspaceRecord,\n  type WorkspaceRegistryOptions,\n} from './workspaceRecords';\n\nexport type {\n  WorkspaceIdentity,\n  WorkspaceIdentityInput,\n  WorkspaceRecord,\n  WorkspaceRegistry,\n  WorkspaceRegistryOptions,\n} from './workspaceRecords';\nexport {\n  createWorkspaceRegistry,\n  gitCommonDirectory,\n  identifyWorkspace,\n  readWorkspaceMarker,\n  writeWorkspaceMarker,\n} from './sync';\n\n/** One queue per registry file, so concurrent read-modify-write cycles in this process never interleave. */\nconst registryWrites = createSerialRunner();\n\nexport interface WorkspaceRegistryAsync {\n  list(): readonly WorkspaceRecord[];\n  add(record: WorkspaceRecord): Promise<void>;\n  remove(id: string): Promise<void>;\n}\n\nfunction errorText(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nasync function canonicalPathAsync(fs: FileSystem, target: string, context: Context): Promise<string> {\n  const absolute = path.resolve(target);\n  const resolved = await fs.canonicalPath(absolute, context);\n  if (resolved.ok) return resolved.value;\n  const parent = path.dirname(absolute);\n  if (parent === absolute) return absolute;\n  return path.join(await canonicalPathAsync(fs, parent, context), path.basename(absolute));\n}\n\nasync function readGitDirectoryAsync(\n  fs: FileSystem,\n  repositoryRoot: string,\n  context: Context,\n): Promise<string | undefined> {\n  const gitPath = path.join(repositoryRoot, GIT_DIRECTORY);\n  try {\n    // fileInfo does not follow links; the canonical path does, as statSync did.\n    const info = await fs.fileInfo(await canonicalPathAsync(fs, gitPath, context), context);\n    if (!info.ok) return undefined;\n    if (info.value.kind === 'directory') return await canonicalPathAsync(fs, gitPath, context);\n    if (info.value.kind !== 'file') return undefined;\n    const content = await fs.readTextFile(gitPath, context);\n    if (!content.ok) return undefined;\n    const target = gitFileTarget(repositoryRoot, content.value);\n    return target === undefined ? undefined : await canonicalPathAsync(fs, target, context);\n  } catch {\n    // Not a git checkout, or one this process cannot read: it has no git data to share.\n    return undefined;\n  }\n}\n\n/** The git data directory shared by every worktree of a repository, if the root is a git checkout. */\nexport async function gitCommonDirectoryAsync(\n  fs: FileSystem,\n  repositoryRoot: string,\n  context: Context,\n): Promise<string | undefined> {\n  const gitDirectory = await readGitDirectoryAsync(fs, repositoryRoot, context);\n  if (!gitDirectory) return undefined;\n  const content = await fs.readTextFile(path.join(gitDirectory, COMMON_DIRECTORY_FILE), context);\n  // A plain checkout has no commondir file; its own git directory is the common one.\n  if (!content.ok) return gitDirectory;\n  const relative = content.value.trim();\n  return relative ? canonicalPathAsync(fs, path.resolve(gitDirectory, relative), context) : gitDirectory;\n}\n\n/**\n * Durable workspace membership, independent of whether a workspace can currently mount.\n * Writes in this process serialise per registry file and publish through a uniquely named\n * temporary file, so concurrent adds and removes never lose an entry or tear the file.\n */\nexport async function createWorkspaceRegistryAsync(\n  fs: FileSystem,\n  options: WorkspaceRegistryOptions,\n  context: Context,\n): Promise<WorkspaceRegistryAsync> {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n  const serial = registryWrites.forKey(filePath);\n\n  const load = async (): Promise<WorkspaceRecord[]> => {\n    let raw: string | undefined;\n    try {\n      raw = await readTextIfExists(fs, filePath, context);\n    } catch (error) {\n      notice(`${filePath} could not be read: ${errorText(error)}`);\n      return [];\n    }\n    return raw === undefined ? [] : parseWorkspaceRecords(raw, filePath, notice);\n  };\n\n  let current = await load();\n\n  const persist = async (next: readonly WorkspaceRecord[]): Promise<void> => {\n    try {\n      const existed = getOrThrow(await fs.exists(options.directory, context));\n      if (!existed) {\n        getOrThrow(await fs.createDir(options.directory, { recursive: true }, context));\n        await nodeHost.setMode(options.directory, DIRECTORY_MODE);\n      }\n      await writeFileAtomic(fs, filePath, serializeWorkspaceRecords(next), context);\n      await nodeHost.setMode(filePath, FILE_MODE);\n    } catch (error) {\n      throw new Error(`${filePath} could not be saved`, { cause: error });\n    }\n  };\n\n  return {\n    list: () => current,\n    // Each write starts from the file, not from memory: another process (a sync, a second\n    // server) may have changed it since this one last read, and its entries must survive.\n    add: (record) =>\n      serial(async () => {\n        assertWorkspaceRecord(record);\n        const next = withWorkspaceRecord(await load(), record);\n        await persist(next);\n        current = next;\n      }),\n    remove: (id) =>\n      serial(async () => {\n        const latest = await load();\n        const next = latest.filter((held) => held.id !== id);\n        if (next.length !== latest.length) await persist(next);\n        current = next;\n      }),\n  };\n}\n\n/** The workspace id recorded in a checkout's git data, if any. */\nexport async function readWorkspaceMarkerAsync(\n  fs: FileSystem,\n  checkoutRoot: string,\n  context: Context,\n): Promise<string | undefined> {\n  const commonDirectory = await gitCommonDirectoryAsync(fs, checkoutRoot, context);\n  if (commonDirectory === undefined) return undefined;\n  const content = await readTextIfExists(fs, path.join(commonDirectory, WORKSPACE_MARKER_FILE), context);\n  return content === undefined ? undefined : parseWorkspaceMarker(content);\n}\n\n/**\n * Records a workspace id in a checkout's git data so the workspace keeps its id when the\n * repository moves. A checkout without git data has nowhere to keep it; returns false.\n */\nexport async function writeWorkspaceMarkerAsync(\n  fs: FileSystem,\n  checkoutRoot: string,\n  id: string,\n  context: Context,\n): Promise<boolean> {\n  const commonDirectory = await gitCommonDirectoryAsync(fs, checkoutRoot, context);\n  if (commonDirectory === undefined) return false;\n  const markerPath = path.join(commonDirectory, WORKSPACE_MARKER_FILE);\n  getOrThrow(await fs.writeFile(markerPath, `${id}\\n`, context));\n  await nodeHost.setMode(markerPath, FILE_MODE);\n  return true;\n}\n\n/**\n * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id\n * in the repository's git data names the workspace: a checkout of a workspace whose root still\n * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else\n * is a new workspace.\n */\nexport async function identifyWorkspaceAsync(\n  fs: FileSystem,\n  input: WorkspaceIdentityInput,\n  context: Context,\n): Promise<WorkspaceIdentity> {\n  const match = matchWorkspace(input);\n  const ownerExists = match?.kind === 'owner' && getOrThrow(await fs.exists(match.record.root, context));\n  return resolveWorkspaceIdentity(input, match, ownerExists, crypto.randomUUID);\n}\n"],"mappings":";;;;;;;;;AA8CuBA,gBAAAA,mBAAmB"}

package/dist/src/services/workspaceRegistry/index.d.mts

@@ -1,47 +1,5 @@
-//#region src/services/workspaceRegistry/index.d.ts
-export interface WorkspaceRecord {
-  id: string;
-  root: string;
-  /** Display name chosen when the workspace was added; the folder basename stands in when absent. */
-  name?: string;
-}
-export interface WorkspaceRegistry {
-  list(): readonly WorkspaceRecord[];
-  add(record: WorkspaceRecord): void;
-  remove(id: string): void;
-}
-export interface WorkspaceRegistryOptions {
-  directory: string;
-  onNotice?: (message: string) => void;
-}
-/** Durable workspace membership, independent of whether a workspace can currently mount. */
-export declare function createWorkspaceRegistry(options: WorkspaceRegistryOptions): WorkspaceRegistry;
-/** The workspace id recorded in a checkout's git data, if any. */
-export declare function readWorkspaceMarker(checkoutRoot: string): string | undefined;
-/**
- * Records a workspace id in a checkout's git data so the workspace keeps its id when the
- * repository moves. A checkout without git data has nowhere to keep it; returns false.
- */
-export declare function writeWorkspaceMarker(checkoutRoot: string, id: string): boolean;
-export interface WorkspaceIdentity {
-  readonly id: string;
-  /** The workspace root. Differs from the checkout when the checkout joins an existing workspace. */
-  readonly root: string;
-  /** The recorded root no longer exists and this checkout takes its place. */
-  readonly moved: boolean;
-}
-/**
- * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id
- * in the repository's git data names the workspace: a checkout of a workspace whose root still
- * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else
- * is a new workspace.
- */
-export declare function identifyWorkspace(input: {
-  readonly records: readonly WorkspaceRecord[];
-  readonly checkoutRoot: string;
-  readonly marker?: string;
-  readonly exists?: (root: string) => boolean;
-  readonly newId?: () => string;
-}): WorkspaceIdentity;
-//#endregion
-//# sourceMappingURL=index.d.mts.map
+import { WorkspaceIdentity, WorkspaceIdentityInput, WorkspaceRecord, WorkspaceRegistry, WorkspaceRegistryOptions } from "./workspaceRecords.mjs";
+import { createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker } from "./sync.mjs";
+import { FileSystem } from "@earendil-works/pi-durable/env";
+import { Context } from "@earendil-works/chord";
+export { type WorkspaceIdentity, type WorkspaceRecord, type WorkspaceRegistry, type WorkspaceRegistryOptions, createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker };

package/dist/src/services/workspaceRegistry/index.mjs

@@ -1,179 +1,10 @@
-import crypto from "node:crypto";
-import fs from "node:fs";
-import path from "node:path";
-//#region src/services/workspaceRegistry/index.ts
-const REGISTRY_FILE = "workspaces.json";
-const GIT_DIRECTORY = ".git";
-const COMMON_DIRECTORY_FILE = "commondir";
-function canonicalPath(target) {
-	const absolute = path.resolve(target);
-	try {
-		return fs.realpathSync.native(absolute);
-	} catch {
-		const parent = path.dirname(absolute);
-		if (parent === absolute) return absolute;
-		return path.join(canonicalPath(parent), path.basename(absolute));
-	}
-}
-function readGitDirectory(repositoryRoot) {
-	const gitPath = path.join(repositoryRoot, GIT_DIRECTORY);
-	try {
-		const stat = fs.statSync(gitPath);
-		if (stat.isDirectory()) return canonicalPath(gitPath);
-		if (!stat.isFile()) return void 0;
-		const match = /^gitdir:\s*(.+)$/imu.exec(fs.readFileSync(gitPath, "utf8").trim());
-		return match?.[1] ? canonicalPath(path.resolve(repositoryRoot, match[1].trim())) : void 0;
-	} catch {
-		return;
-	}
-}
-/** The git data directory shared by every worktree of a repository, if the root is a git checkout. */
-function gitCommonDirectory(repositoryRoot) {
-	const gitDirectory = readGitDirectory(repositoryRoot);
-	if (!gitDirectory) return void 0;
-	try {
-		const relative = fs.readFileSync(path.join(gitDirectory, COMMON_DIRECTORY_FILE), "utf8").trim();
-		return relative ? canonicalPath(path.resolve(gitDirectory, relative)) : gitDirectory;
-	} catch {
-		return gitDirectory;
-	}
-}
-/** Kept in the repository's git data, which moves with the checkout and is shared by its worktrees. */
-const WORKSPACE_MARKER_FILE = "po-workspace-id";
-const DIRECTORY_MODE = 448;
-const FILE_MODE = 384;
-function parseRecord(value) {
-	if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
-	const record = value;
-	if (typeof record.id !== "string" || record.id === "") return void 0;
-	if (typeof record.root !== "string" || !path.isAbsolute(record.root)) return void 0;
-	const name = typeof record.name === "string" && record.name.trim() !== "" ? record.name : void 0;
-	return {
-		id: record.id,
-		root: record.root,
-		...name === void 0 ? {} : { name }
-	};
-}
-/** Durable workspace membership, independent of whether a workspace can currently mount. */
-function createWorkspaceRegistry(options) {
-	const notice = options.onNotice ?? (() => {});
-	const filePath = path.join(options.directory, REGISTRY_FILE);
-	const load = () => {
-		let raw;
-		try {
-			raw = fs.readFileSync(filePath, "utf8");
-		} catch (error) {
-			if (error instanceof Error && "code" in error && error.code === "ENOENT") return [];
-			notice(`${filePath} could not be read: ${error instanceof Error ? error.message : String(error)}`);
-			return [];
-		}
-		let parsed;
-		try {
-			parsed = JSON.parse(raw);
-		} catch {
-			notice(`workspaces at ${filePath} are not valid JSON; none will be restored`);
-			return [];
-		}
-		if (!Array.isArray(parsed)) {
-			notice(`workspaces at ${filePath} are not a list; none will be restored`);
-			return [];
-		}
-		const records = [];
-		for (const entry of parsed) {
-			const record = parseRecord(entry);
-			if (record === void 0) notice(`workspaces at ${filePath} contain an unusable entry; skipping it`);
-			else if (!records.some((candidate) => candidate.id === record.id)) records.push(record);
-		}
-		return records;
-	};
-	let current = load();
-	const persist = (next) => {
-		const temporary = `${filePath}.${String(process.pid)}.tmp`;
-		try {
-			fs.mkdirSync(options.directory, {
-				recursive: true,
-				mode: DIRECTORY_MODE
-			});
-			fs.writeFileSync(temporary, `${JSON.stringify(next, void 0, 2)}\n`, { mode: FILE_MODE });
-			fs.renameSync(temporary, filePath);
-		} catch (error) {
-			try {
-				fs.rmSync(temporary, { force: true });
-			} catch (cleanupError) {
-				notice(`${temporary} could not be removed: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
-			}
-			throw new Error(`${filePath} could not be saved`, { cause: error });
-		}
-	};
-	return {
-		list: () => current,
-		add(record) {
-			if (record.id === "" || !path.isAbsolute(record.root)) throw new Error("Invalid workspace record.");
-			const latest = load();
-			const next = latest.some((held) => held.id === record.id) ? latest.map((held) => held.id === record.id ? record : held) : [...latest, record];
-			persist(next);
-			current = next;
-		},
-		remove(id) {
-			const latest = load();
-			const next = latest.filter((held) => held.id !== id);
-			if (next.length !== latest.length) persist(next);
-			current = next;
-		}
-	};
-}
-/** The workspace id recorded in a checkout's git data, if any. */
-function readWorkspaceMarker(checkoutRoot) {
-	const commonDirectory = gitCommonDirectory(checkoutRoot);
-	if (commonDirectory === void 0) return void 0;
-	try {
-		const id = fs.readFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), "utf8").trim();
-		return id === "" ? void 0 : id;
-	} catch (error) {
-		if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
-		throw error;
-	}
-}
-/**
-* Records a workspace id in a checkout's git data so the workspace keeps its id when the
-* repository moves. A checkout without git data has nowhere to keep it; returns false.
-*/
-function writeWorkspaceMarker(checkoutRoot, id) {
-	const commonDirectory = gitCommonDirectory(checkoutRoot);
-	if (commonDirectory === void 0) return false;
-	fs.writeFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), `${id}\n`, { mode: FILE_MODE });
-	return true;
-}
-/**
-* Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id
-* in the repository's git data names the workspace: a checkout of a workspace whose root still
-* exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else
-* is a new workspace.
-*/
-function identifyWorkspace(input) {
-	const exact = input.records.find((record) => record.root === input.checkoutRoot);
-	if (exact !== void 0) return {
-		id: exact.id,
-		root: exact.root,
-		moved: false
-	};
-	const owner = input.marker === void 0 ? void 0 : input.records.find((record) => record.id === input.marker);
-	if (owner !== void 0) return (input.exists ?? fs.existsSync)(owner.root) ? {
-		id: owner.id,
-		root: owner.root,
-		moved: false
-	} : {
-		id: owner.id,
-		root: input.checkoutRoot,
-		moved: true
-	};
-	return {
-		id: input.marker ?? (input.newId ?? crypto.randomUUID)(),
-		root: input.checkoutRoot,
-		moved: false
-	};
-}
+import "../platformFiles/index.mjs";
+import { createSerialRunner } from "../serialRunner/index.mjs";
 //#endregion
-export { createWorkspaceRegistry, gitCommonDirectory, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker };
+export { createWorkspaceRegistry, identifyWorkspace, readWorkspaceMarker, writeWorkspaceMarker } from "./sync.mjs";
+import "node:crypto";
+import "node:path";
+import "@earendil-works/pi-durable/env";
+createSerialRunner();
 
 //# sourceMappingURL=index.mjs.map

package/dist/src/services/workspaceRegistry/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/workspaceRegistry/index.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nconst REGISTRY_FILE = 'workspaces.json';\nconst GIT_DIRECTORY = '.git';\nconst COMMON_DIRECTORY_FILE = 'commondir';\n\nfunction canonicalPath(target: string): string {\n  const absolute = path.resolve(target);\n  try {\n    return fs.realpathSync.native(absolute);\n  } catch {\n    const parent = path.dirname(absolute);\n    if (parent === absolute) return absolute;\n    return path.join(canonicalPath(parent), path.basename(absolute));\n  }\n}\n\nfunction readGitDirectory(repositoryRoot: string): string | undefined {\n  const gitPath = path.join(repositoryRoot, GIT_DIRECTORY);\n  try {\n    const stat = fs.statSync(gitPath);\n    if (stat.isDirectory()) return canonicalPath(gitPath);\n    if (!stat.isFile()) return undefined;\n    const match = /^gitdir:\\s*(.+)$/imu.exec(fs.readFileSync(gitPath, 'utf8').trim());\n    return match?.[1] ? canonicalPath(path.resolve(repositoryRoot, match[1].trim())) : undefined;\n  } catch {\n    // Not a git checkout, or one this process cannot read: it has no git data to share.\n    return undefined;\n  }\n}\n\n/** The git data directory shared by every worktree of a repository, if the root is a git checkout. */\nexport function gitCommonDirectory(repositoryRoot: string): string | undefined {\n  const gitDirectory = readGitDirectory(repositoryRoot);\n  if (!gitDirectory) return undefined;\n  try {\n    const relative = fs.readFileSync(path.join(gitDirectory, COMMON_DIRECTORY_FILE), 'utf8').trim();\n    return relative ? canonicalPath(path.resolve(gitDirectory, relative)) : gitDirectory;\n  } catch {\n    // A plain checkout has no commondir file; its own git directory is the common one.\n    return gitDirectory;\n  }\n}\n/** Kept in the repository's git data, which moves with the checkout and is shared by its worktrees. */\nconst WORKSPACE_MARKER_FILE = 'po-workspace-id';\nconst DIRECTORY_MODE = 0o700;\nconst FILE_MODE = 0o600;\n\nexport interface WorkspaceRecord {\n  id: string;\n  root: string;\n  /** Display name chosen when the workspace was added; the folder basename stands in when absent. */\n  name?: string;\n}\n\nexport interface WorkspaceRegistry {\n  list(): readonly WorkspaceRecord[];\n  add(record: WorkspaceRecord): void;\n  remove(id: string): void;\n}\n\nexport interface WorkspaceRegistryOptions {\n  directory: string;\n  onNotice?: (message: string) => void;\n}\n\nfunction parseRecord(value: unknown): WorkspaceRecord | undefined {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return undefined;\n  const record = value as Record<string, unknown>;\n  if (typeof record.id !== 'string' || record.id === '') return undefined;\n  if (typeof record.root !== 'string' || !path.isAbsolute(record.root)) return undefined;\n  const name = typeof record.name === 'string' && record.name.trim() !== '' ? record.name : undefined;\n  return { id: record.id, root: record.root, ...(name === undefined ? {} : { name }) };\n}\n\n/** Durable workspace membership, independent of whether a workspace can currently mount. */\nexport function createWorkspaceRegistry(options: WorkspaceRegistryOptions): WorkspaceRegistry {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n\n  const load = (): WorkspaceRecord[] => {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return [];\n      notice(`${filePath} could not be read: ${error instanceof Error ? error.message : String(error)}`);\n      return [];\n    }\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      notice(`workspaces at ${filePath} are not valid JSON; none will be restored`);\n      return [];\n    }\n    if (!Array.isArray(parsed)) {\n      notice(`workspaces at ${filePath} are not a list; none will be restored`);\n      return [];\n    }\n    const records: WorkspaceRecord[] = [];\n    for (const entry of parsed) {\n      const record = parseRecord(entry);\n      if (record === undefined) notice(`workspaces at ${filePath} contain an unusable entry; skipping it`);\n      else if (!records.some((candidate) => candidate.id === record.id)) records.push(record);\n    }\n    return records;\n  };\n\n  let current = load();\n\n  const persist = (next: readonly WorkspaceRecord[]): void => {\n    const temporary = `${filePath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.directory, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, `${JSON.stringify(next, undefined, 2)}\\n`, { mode: FILE_MODE });\n      fs.renameSync(temporary, filePath);\n    } catch (error) {\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch (cleanupError) {\n        notice(\n          `${temporary} could not be removed: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`,\n        );\n      }\n      throw new Error(`${filePath} could not be saved`, { cause: error });\n    }\n  };\n\n  return {\n    list: () => current,\n    // Each write starts from the file, not from memory: another process (a sync, a second\n    // server) may have changed it since this one last read, and its entries must survive.\n    add(record) {\n      if (record.id === '' || !path.isAbsolute(record.root)) throw new Error('Invalid workspace record.');\n      const latest = load();\n      // Replaced in place: registry order is the tie-break when checkouts are matched to workspaces.\n      const next = latest.some((held) => held.id === record.id)\n        ? latest.map((held) => (held.id === record.id ? record : held))\n        : [...latest, record];\n      persist(next);\n      current = next;\n    },\n    remove(id) {\n      const latest = load();\n      const next = latest.filter((held) => held.id !== id);\n      if (next.length !== latest.length) persist(next);\n      current = next;\n    },\n  };\n}\n\n/** The workspace id recorded in a checkout's git data, if any. */\nexport function readWorkspaceMarker(checkoutRoot: string): string | undefined {\n  const commonDirectory = gitCommonDirectory(checkoutRoot);\n  if (commonDirectory === undefined) return undefined;\n  try {\n    const id = fs.readFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), 'utf8').trim();\n    return id === '' ? undefined : id;\n  } catch (error) {\n    if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/**\n * Records a workspace id in a checkout's git data so the workspace keeps its id when the\n * repository moves. A checkout without git data has nowhere to keep it; returns false.\n */\nexport function writeWorkspaceMarker(checkoutRoot: string, id: string): boolean {\n  const commonDirectory = gitCommonDirectory(checkoutRoot);\n  if (commonDirectory === undefined) return false;\n  fs.writeFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), `${id}\\n`, { mode: FILE_MODE });\n  return true;\n}\n\nexport interface WorkspaceIdentity {\n  readonly id: string;\n  /** The workspace root. Differs from the checkout when the checkout joins an existing workspace. */\n  readonly root: string;\n  /** The recorded root no longer exists and this checkout takes its place. */\n  readonly moved: boolean;\n}\n\n/**\n * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id\n * in the repository's git data names the workspace: a checkout of a workspace whose root still\n * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else\n * is a new workspace.\n */\nexport function identifyWorkspace(input: {\n  readonly records: readonly WorkspaceRecord[];\n  readonly checkoutRoot: string;\n  readonly marker?: string;\n  readonly exists?: (root: string) => boolean;\n  readonly newId?: () => string;\n}): WorkspaceIdentity {\n  const exact = input.records.find((record) => record.root === input.checkoutRoot);\n  if (exact !== undefined) return { id: exact.id, root: exact.root, moved: false };\n  const owner = input.marker === undefined ? undefined : input.records.find((record) => record.id === input.marker);\n  if (owner !== undefined) {\n    const exists = input.exists ?? fs.existsSync;\n    return exists(owner.root)\n      ? { id: owner.id, root: owner.root, moved: false }\n      : { id: owner.id, root: input.checkoutRoot, moved: true };\n  }\n  return { id: input.marker ?? (input.newId ?? crypto.randomUUID)(), root: input.checkoutRoot, moved: false };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/workspaceRegistry/index.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\n\nimport { nodeHost } from '../nodeHost';\nimport { readTextIfExists, writeFileAtomic } from '../platformFiles';\nimport { createSerialRunner } from '../serialRunner';\nimport {\n  assertWorkspaceRecord,\n  COMMON_DIRECTORY_FILE,\n  DIRECTORY_MODE,\n  FILE_MODE,\n  GIT_DIRECTORY,\n  gitFileTarget,\n  matchWorkspace,\n  parseWorkspaceMarker,\n  parseWorkspaceRecords,\n  REGISTRY_FILE,\n  resolveWorkspaceIdentity,\n  serializeWorkspaceRecords,\n  withWorkspaceRecord,\n  WORKSPACE_MARKER_FILE,\n  type WorkspaceIdentity,\n  type WorkspaceIdentityInput,\n  type WorkspaceRecord,\n  type WorkspaceRegistryOptions,\n} from './workspaceRecords';\n\nexport type {\n  WorkspaceIdentity,\n  WorkspaceIdentityInput,\n  WorkspaceRecord,\n  WorkspaceRegistry,\n  WorkspaceRegistryOptions,\n} from './workspaceRecords';\nexport {\n  createWorkspaceRegistry,\n  gitCommonDirectory,\n  identifyWorkspace,\n  readWorkspaceMarker,\n  writeWorkspaceMarker,\n} from './sync';\n\n/** One queue per registry file, so concurrent read-modify-write cycles in this process never interleave. */\nconst registryWrites = createSerialRunner();\n\nexport interface WorkspaceRegistryAsync {\n  list(): readonly WorkspaceRecord[];\n  add(record: WorkspaceRecord): Promise<void>;\n  remove(id: string): Promise<void>;\n}\n\nfunction errorText(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nasync function canonicalPathAsync(fs: FileSystem, target: string, context: Context): Promise<string> {\n  const absolute = path.resolve(target);\n  const resolved = await fs.canonicalPath(absolute, context);\n  if (resolved.ok) return resolved.value;\n  const parent = path.dirname(absolute);\n  if (parent === absolute) return absolute;\n  return path.join(await canonicalPathAsync(fs, parent, context), path.basename(absolute));\n}\n\nasync function readGitDirectoryAsync(\n  fs: FileSystem,\n  repositoryRoot: string,\n  context: Context,\n): Promise<string | undefined> {\n  const gitPath = path.join(repositoryRoot, GIT_DIRECTORY);\n  try {\n    // fileInfo does not follow links; the canonical path does, as statSync did.\n    const info = await fs.fileInfo(await canonicalPathAsync(fs, gitPath, context), context);\n    if (!info.ok) return undefined;\n    if (info.value.kind === 'directory') return await canonicalPathAsync(fs, gitPath, context);\n    if (info.value.kind !== 'file') return undefined;\n    const content = await fs.readTextFile(gitPath, context);\n    if (!content.ok) return undefined;\n    const target = gitFileTarget(repositoryRoot, content.value);\n    return target === undefined ? undefined : await canonicalPathAsync(fs, target, context);\n  } catch {\n    // Not a git checkout, or one this process cannot read: it has no git data to share.\n    return undefined;\n  }\n}\n\n/** The git data directory shared by every worktree of a repository, if the root is a git checkout. */\nexport async function gitCommonDirectoryAsync(\n  fs: FileSystem,\n  repositoryRoot: string,\n  context: Context,\n): Promise<string | undefined> {\n  const gitDirectory = await readGitDirectoryAsync(fs, repositoryRoot, context);\n  if (!gitDirectory) return undefined;\n  const content = await fs.readTextFile(path.join(gitDirectory, COMMON_DIRECTORY_FILE), context);\n  // A plain checkout has no commondir file; its own git directory is the common one.\n  if (!content.ok) return gitDirectory;\n  const relative = content.value.trim();\n  return relative ? canonicalPathAsync(fs, path.resolve(gitDirectory, relative), context) : gitDirectory;\n}\n\n/**\n * Durable workspace membership, independent of whether a workspace can currently mount.\n * Writes in this process serialise per registry file and publish through a uniquely named\n * temporary file, so concurrent adds and removes never lose an entry or tear the file.\n */\nexport async function createWorkspaceRegistryAsync(\n  fs: FileSystem,\n  options: WorkspaceRegistryOptions,\n  context: Context,\n): Promise<WorkspaceRegistryAsync> {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n  const serial = registryWrites.forKey(filePath);\n\n  const load = async (): Promise<WorkspaceRecord[]> => {\n    let raw: string | undefined;\n    try {\n      raw = await readTextIfExists(fs, filePath, context);\n    } catch (error) {\n      notice(`${filePath} could not be read: ${errorText(error)}`);\n      return [];\n    }\n    return raw === undefined ? [] : parseWorkspaceRecords(raw, filePath, notice);\n  };\n\n  let current = await load();\n\n  const persist = async (next: readonly WorkspaceRecord[]): Promise<void> => {\n    try {\n      const existed = getOrThrow(await fs.exists(options.directory, context));\n      if (!existed) {\n        getOrThrow(await fs.createDir(options.directory, { recursive: true }, context));\n        await nodeHost.setMode(options.directory, DIRECTORY_MODE);\n      }\n      await writeFileAtomic(fs, filePath, serializeWorkspaceRecords(next), context);\n      await nodeHost.setMode(filePath, FILE_MODE);\n    } catch (error) {\n      throw new Error(`${filePath} could not be saved`, { cause: error });\n    }\n  };\n\n  return {\n    list: () => current,\n    // Each write starts from the file, not from memory: another process (a sync, a second\n    // server) may have changed it since this one last read, and its entries must survive.\n    add: (record) =>\n      serial(async () => {\n        assertWorkspaceRecord(record);\n        const next = withWorkspaceRecord(await load(), record);\n        await persist(next);\n        current = next;\n      }),\n    remove: (id) =>\n      serial(async () => {\n        const latest = await load();\n        const next = latest.filter((held) => held.id !== id);\n        if (next.length !== latest.length) await persist(next);\n        current = next;\n      }),\n  };\n}\n\n/** The workspace id recorded in a checkout's git data, if any. */\nexport async function readWorkspaceMarkerAsync(\n  fs: FileSystem,\n  checkoutRoot: string,\n  context: Context,\n): Promise<string | undefined> {\n  const commonDirectory = await gitCommonDirectoryAsync(fs, checkoutRoot, context);\n  if (commonDirectory === undefined) return undefined;\n  const content = await readTextIfExists(fs, path.join(commonDirectory, WORKSPACE_MARKER_FILE), context);\n  return content === undefined ? undefined : parseWorkspaceMarker(content);\n}\n\n/**\n * Records a workspace id in a checkout's git data so the workspace keeps its id when the\n * repository moves. A checkout without git data has nowhere to keep it; returns false.\n */\nexport async function writeWorkspaceMarkerAsync(\n  fs: FileSystem,\n  checkoutRoot: string,\n  id: string,\n  context: Context,\n): Promise<boolean> {\n  const commonDirectory = await gitCommonDirectoryAsync(fs, checkoutRoot, context);\n  if (commonDirectory === undefined) return false;\n  const markerPath = path.join(commonDirectory, WORKSPACE_MARKER_FILE);\n  getOrThrow(await fs.writeFile(markerPath, `${id}\\n`, context));\n  await nodeHost.setMode(markerPath, FILE_MODE);\n  return true;\n}\n\n/**\n * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id\n * in the repository's git data names the workspace: a checkout of a workspace whose root still\n * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else\n * is a new workspace.\n */\nexport async function identifyWorkspaceAsync(\n  fs: FileSystem,\n  input: WorkspaceIdentityInput,\n  context: Context,\n): Promise<WorkspaceIdentity> {\n  const match = matchWorkspace(input);\n  const ownerExists = match?.kind === 'owner' && getOrThrow(await fs.exists(match.record.root, context));\n  return resolveWorkspaceIdentity(input, match, ownerExists, crypto.randomUUID);\n}\n"],"mappings":";;;;;;;AA8CuB,mBAAmB"}

package/dist/src/services/workspaceRegistry/sync.cjs

@@ -0,0 +1,148 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_workspaceRecords = require("./workspaceRecords.cjs");
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/services/workspaceRegistry/sync.ts
+function canonicalPath(target) {
+	const absolute = node_path.default.resolve(target);
+	try {
+		return node_fs.default.realpathSync.native(absolute);
+	} catch {
+		const parent = node_path.default.dirname(absolute);
+		if (parent === absolute) return absolute;
+		return node_path.default.join(canonicalPath(parent), node_path.default.basename(absolute));
+	}
+}
+function readGitDirectory(repositoryRoot) {
+	const gitPath = node_path.default.join(repositoryRoot, require_workspaceRecords.GIT_DIRECTORY);
+	try {
+		const stat = node_fs.default.statSync(gitPath);
+		if (stat.isDirectory()) return canonicalPath(gitPath);
+		if (!stat.isFile()) return void 0;
+		const target = require_workspaceRecords.gitFileTarget(repositoryRoot, node_fs.default.readFileSync(gitPath, "utf8"));
+		return target === void 0 ? void 0 : canonicalPath(target);
+	} catch {
+		return;
+	}
+}
+/**
+* The git data directory shared by every worktree of a repository, if the root is a git checkout.
+*
+* @deprecated Node-only sync shim; use gitCommonDirectoryAsync. Removed in M2.
+*/
+function gitCommonDirectory(repositoryRoot) {
+	const gitDirectory = readGitDirectory(repositoryRoot);
+	if (!gitDirectory) return void 0;
+	try {
+		const relative = node_fs.default.readFileSync(node_path.default.join(gitDirectory, require_workspaceRecords.COMMON_DIRECTORY_FILE), "utf8").trim();
+		return relative ? canonicalPath(node_path.default.resolve(gitDirectory, relative)) : gitDirectory;
+	} catch {
+		return gitDirectory;
+	}
+}
+/**
+* Durable workspace membership, independent of whether a workspace can currently mount.
+*
+* @deprecated Node-only sync shim; use createWorkspaceRegistryAsync. Removed in M2.
+*/
+function createWorkspaceRegistry(options) {
+	const notice = options.onNotice ?? (() => {});
+	const filePath = node_path.default.join(options.directory, require_workspaceRecords.REGISTRY_FILE);
+	const load = () => {
+		let raw;
+		try {
+			raw = node_fs.default.readFileSync(filePath, "utf8");
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") return [];
+			notice(`${filePath} could not be read: ${error instanceof Error ? error.message : String(error)}`);
+			return [];
+		}
+		return require_workspaceRecords.parseWorkspaceRecords(raw, filePath, notice);
+	};
+	let current = load();
+	const persist = (next) => {
+		const temporary = `${filePath}.${String(process.pid)}.tmp`;
+		try {
+			node_fs.default.mkdirSync(options.directory, {
+				recursive: true,
+				mode: 448
+			});
+			node_fs.default.writeFileSync(temporary, require_workspaceRecords.serializeWorkspaceRecords(next), { mode: 384 });
+			node_fs.default.renameSync(temporary, filePath);
+		} catch (error) {
+			try {
+				node_fs.default.rmSync(temporary, { force: true });
+			} catch (cleanupError) {
+				notice(`${temporary} could not be removed: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
+			}
+			throw new Error(`${filePath} could not be saved`, { cause: error });
+		}
+	};
+	return {
+		list: () => current,
+		add(record) {
+			require_workspaceRecords.assertWorkspaceRecord(record);
+			const next = require_workspaceRecords.withWorkspaceRecord(load(), record);
+			persist(next);
+			current = next;
+		},
+		remove(id) {
+			const latest = load();
+			const next = latest.filter((held) => held.id !== id);
+			if (next.length !== latest.length) persist(next);
+			current = next;
+		}
+	};
+}
+/**
+* The workspace id recorded in a checkout's git data, if any.
+*
+* @deprecated Node-only sync shim; use readWorkspaceMarkerAsync. Removed in M2.
+*/
+function readWorkspaceMarker(checkoutRoot) {
+	const commonDirectory = gitCommonDirectory(checkoutRoot);
+	if (commonDirectory === void 0) return void 0;
+	try {
+		return require_workspaceRecords.parseWorkspaceMarker(node_fs.default.readFileSync(node_path.default.join(commonDirectory, require_workspaceRecords.WORKSPACE_MARKER_FILE), "utf8"));
+	} catch (error) {
+		if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
+		throw error;
+	}
+}
+/**
+* Records a workspace id in a checkout's git data so the workspace keeps its id when the
+* repository moves. A checkout without git data has nowhere to keep it; returns false.
+*
+* @deprecated Node-only sync shim; use writeWorkspaceMarkerAsync. Removed in M2.
+*/
+function writeWorkspaceMarker(checkoutRoot, id) {
+	const commonDirectory = gitCommonDirectory(checkoutRoot);
+	if (commonDirectory === void 0) return false;
+	node_fs.default.writeFileSync(node_path.default.join(commonDirectory, require_workspaceRecords.WORKSPACE_MARKER_FILE), `${id}\n`, { mode: 384 });
+	return true;
+}
+/**
+* Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id
+* in the repository's git data names the workspace: a checkout of a workspace whose root still
+* exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else
+* is a new workspace.
+*
+* @deprecated Node-only sync shim; use identifyWorkspaceAsync. Removed in M2.
+*/
+function identifyWorkspace(input) {
+	const match = require_workspaceRecords.matchWorkspace(input);
+	const exists = input.exists ?? node_fs.default.existsSync;
+	return require_workspaceRecords.resolveWorkspaceIdentity(input, match, match?.kind === "owner" && exists(match.record.root), node_crypto.default.randomUUID);
+}
+//#endregion
+exports.createWorkspaceRegistry = createWorkspaceRegistry;
+exports.gitCommonDirectory = gitCommonDirectory;
+exports.identifyWorkspace = identifyWorkspace;
+exports.readWorkspaceMarker = readWorkspaceMarker;
+exports.writeWorkspaceMarker = writeWorkspaceMarker;
+
+//# sourceMappingURL=sync.cjs.map

package/dist/src/services/workspaceRegistry/sync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.cjs","names":["path","fs","GIT_DIRECTORY","gitFileTarget","COMMON_DIRECTORY_FILE","REGISTRY_FILE","parseWorkspaceRecords","serializeWorkspaceRecords","withWorkspaceRecord","parseWorkspaceMarker","WORKSPACE_MARKER_FILE","matchWorkspace","resolveWorkspaceIdentity","crypto"],"sources":["../../../../src/services/workspaceRegistry/sync.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport {\n  assertWorkspaceRecord,\n  COMMON_DIRECTORY_FILE,\n  DIRECTORY_MODE,\n  FILE_MODE,\n  GIT_DIRECTORY,\n  gitFileTarget,\n  matchWorkspace,\n  parseWorkspaceMarker,\n  parseWorkspaceRecords,\n  REGISTRY_FILE,\n  resolveWorkspaceIdentity,\n  serializeWorkspaceRecords,\n  withWorkspaceRecord,\n  WORKSPACE_MARKER_FILE,\n  type WorkspaceIdentity,\n  type WorkspaceIdentityInput,\n  type WorkspaceRecord,\n  type WorkspaceRegistry,\n  type WorkspaceRegistryOptions,\n} from './workspaceRecords';\n\nfunction canonicalPath(target: string): string {\n  const absolute = path.resolve(target);\n  try {\n    return fs.realpathSync.native(absolute);\n  } catch {\n    const parent = path.dirname(absolute);\n    if (parent === absolute) return absolute;\n    return path.join(canonicalPath(parent), path.basename(absolute));\n  }\n}\n\nfunction readGitDirectory(repositoryRoot: string): string | undefined {\n  const gitPath = path.join(repositoryRoot, GIT_DIRECTORY);\n  try {\n    const stat = fs.statSync(gitPath);\n    if (stat.isDirectory()) return canonicalPath(gitPath);\n    if (!stat.isFile()) return undefined;\n    const target = gitFileTarget(repositoryRoot, fs.readFileSync(gitPath, 'utf8'));\n    return target === undefined ? undefined : canonicalPath(target);\n  } catch {\n    // Not a git checkout, or one this process cannot read: it has no git data to share.\n    return undefined;\n  }\n}\n\n/**\n * The git data directory shared by every worktree of a repository, if the root is a git checkout.\n *\n * @deprecated Node-only sync shim; use gitCommonDirectoryAsync. Removed in M2.\n */\nexport function gitCommonDirectory(repositoryRoot: string): string | undefined {\n  const gitDirectory = readGitDirectory(repositoryRoot);\n  if (!gitDirectory) return undefined;\n  try {\n    const relative = fs.readFileSync(path.join(gitDirectory, COMMON_DIRECTORY_FILE), 'utf8').trim();\n    return relative ? canonicalPath(path.resolve(gitDirectory, relative)) : gitDirectory;\n  } catch {\n    // A plain checkout has no commondir file; its own git directory is the common one.\n    return gitDirectory;\n  }\n}\n\n/**\n * Durable workspace membership, independent of whether a workspace can currently mount.\n *\n * @deprecated Node-only sync shim; use createWorkspaceRegistryAsync. Removed in M2.\n */\nexport function createWorkspaceRegistry(options: WorkspaceRegistryOptions): WorkspaceRegistry {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n\n  const load = (): WorkspaceRecord[] => {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return [];\n      notice(`${filePath} could not be read: ${error instanceof Error ? error.message : String(error)}`);\n      return [];\n    }\n    return parseWorkspaceRecords(raw, filePath, notice);\n  };\n\n  let current = load();\n\n  const persist = (next: readonly WorkspaceRecord[]): void => {\n    const temporary = `${filePath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.directory, { recursive: true, mode: DIRECTORY_MODE });\n      fs.writeFileSync(temporary, serializeWorkspaceRecords(next), { mode: FILE_MODE });\n      fs.renameSync(temporary, filePath);\n    } catch (error) {\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch (cleanupError) {\n        notice(\n          `${temporary} could not be removed: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`,\n        );\n      }\n      throw new Error(`${filePath} could not be saved`, { cause: error });\n    }\n  };\n\n  return {\n    list: () => current,\n    // Each write starts from the file, not from memory: another process (a sync, a second\n    // server) may have changed it since this one last read, and its entries must survive.\n    add(record) {\n      assertWorkspaceRecord(record);\n      const next = withWorkspaceRecord(load(), record);\n      persist(next);\n      current = next;\n    },\n    remove(id) {\n      const latest = load();\n      const next = latest.filter((held) => held.id !== id);\n      if (next.length !== latest.length) persist(next);\n      current = next;\n    },\n  };\n}\n\n/**\n * The workspace id recorded in a checkout's git data, if any.\n *\n * @deprecated Node-only sync shim; use readWorkspaceMarkerAsync. Removed in M2.\n */\nexport function readWorkspaceMarker(checkoutRoot: string): string | undefined {\n  const commonDirectory = gitCommonDirectory(checkoutRoot);\n  if (commonDirectory === undefined) return undefined;\n  try {\n    return parseWorkspaceMarker(fs.readFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), 'utf8'));\n  } catch (error) {\n    if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined;\n    throw error;\n  }\n}\n\n/**\n * Records a workspace id in a checkout's git data so the workspace keeps its id when the\n * repository moves. A checkout without git data has nowhere to keep it; returns false.\n *\n * @deprecated Node-only sync shim; use writeWorkspaceMarkerAsync. Removed in M2.\n */\nexport function writeWorkspaceMarker(checkoutRoot: string, id: string): boolean {\n  const commonDirectory = gitCommonDirectory(checkoutRoot);\n  if (commonDirectory === undefined) return false;\n  fs.writeFileSync(path.join(commonDirectory, WORKSPACE_MARKER_FILE), `${id}\\n`, { mode: FILE_MODE });\n  return true;\n}\n\n/**\n * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id\n * in the repository's git data names the workspace: a checkout of a workspace whose root still\n * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else\n * is a new workspace.\n *\n * @deprecated Node-only sync shim; use identifyWorkspaceAsync. Removed in M2.\n */\nexport function identifyWorkspace(\n  input: WorkspaceIdentityInput & { readonly exists?: (root: string) => boolean },\n): WorkspaceIdentity {\n  const match = matchWorkspace(input);\n  const exists = input.exists ?? fs.existsSync;\n  return resolveWorkspaceIdentity(\n    input,\n    match,\n    match?.kind === 'owner' && exists(match.record.root),\n    crypto.randomUUID,\n  );\n}\n"],"mappings":"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"}

package/dist/src/services/workspaceRegistry/sync.d.mts

@@ -0,0 +1,34 @@
+import { WorkspaceIdentity, WorkspaceIdentityInput, WorkspaceRegistry, WorkspaceRegistryOptions } from "./workspaceRecords.mjs";
+//#region src/services/workspaceRegistry/sync.d.ts
+/**
+ * Durable workspace membership, independent of whether a workspace can currently mount.
+ *
+ * @deprecated Node-only sync shim; use createWorkspaceRegistryAsync. Removed in M2.
+ */
+export declare function createWorkspaceRegistry(options: WorkspaceRegistryOptions): WorkspaceRegistry;
+/**
+ * The workspace id recorded in a checkout's git data, if any.
+ *
+ * @deprecated Node-only sync shim; use readWorkspaceMarkerAsync. Removed in M2.
+ */
+export declare function readWorkspaceMarker(checkoutRoot: string): string | undefined;
+/**
+ * Records a workspace id in a checkout's git data so the workspace keeps its id when the
+ * repository moves. A checkout without git data has nowhere to keep it; returns false.
+ *
+ * @deprecated Node-only sync shim; use writeWorkspaceMarkerAsync. Removed in M2.
+ */
+export declare function writeWorkspaceMarker(checkoutRoot: string, id: string): boolean;
+/**
+ * Decides which workspace a checkout belongs to. An exact root match wins. Otherwise the id
+ * in the repository's git data names the workspace: a checkout of a workspace whose root still
+ * exists joins it, and one whose recorded root is gone is that workspace, moved. Anything else
+ * is a new workspace.
+ *
+ * @deprecated Node-only sync shim; use identifyWorkspaceAsync. Removed in M2.
+ */
+export declare function identifyWorkspace(input: WorkspaceIdentityInput & {
+  readonly exists?: (root: string) => boolean;
+}): WorkspaceIdentity;
+//#endregion
+//# sourceMappingURL=sync.d.mts.map

package/dist/src/services/workspaceRegistry/sync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.mts","names":[],"sources":["../../../../src/services/workspaceRegistry/sync.ts"],"mappings":";;;;;;;wBAyEgB,wBAAwB,SAAS,2BAA2B;;;;;;wBA4D5D,oBAAoB;;;;;;;wBAiBpB,qBAAqB,sBAAsB;;;;;;;;;wBAe3C,kBACd,OAAO;WAAoC,UAAU;IACpD"}