Function bindWorkspace

apps/desktop/src/main/design-workspace.ts:143–198

(
  db: Database,
  designId: string,
  workspacePath: string | null,
  migrateFiles: boolean,
  workspaceMode?: WorkspaceMode,
)

}

export async function bindWorkspace(
  db: Database,
  designId: string,
  workspacePath: string | null,
  migrateFiles: boolean,
  workspaceMode?: WorkspaceMode,
): Promise<Design> {
  const current = requireDesign(db, designId);

  if (workspacePath === null) {
    logger.info('workspace.clear.start', { designId });
    const cleared = clearDesignWorkspace(db, designId);
    if (cleared === null) {
      throw new Error(`Design not found: ${designId}`);
    }
    logger.info('workspace.clear.done', { designId });
    return cleared;
  }

  const normalizedPath = normalizeWorkspacePath(workspacePath);
  const comparisonPath = workspacePathComparisonKey(normalizedPath);
  if (
    current.workspacePath !== null &&
    workspacePathComparisonKey(current.workspacePath) === comparisonPath
  ) {
    logger.info('workspace.bind.noop', { designId, workspacePath: normalizedPath });
    return current;
  }
  const conflict = findWorkspaceConflict(db, designId, normalizedPath);
  if (conflict !== null) {
    throw new Error(workspaceConflictMessage(conflict));
  }
  await assertExistingWorkspaceDirectory(normalizedPath);

  logger.info('workspace.bind.start', {
    designId,
    workspacePath: normalizedPath,
    migrateFiles,
  });

  if (migrateFiles) {
    await migrateWorkspaceFiles(db, designId, normalizedPath);
  }

  const updated = updateDesignWorkspace(db, designId, normalizedPath, workspaceMode);
  if (updated === null) {
    throw new Error(`Design not found: ${designId}`);
  }

  logger.info('workspace.bind.done', {
    designId,
    workspacePath: normalizedPath,
    migrateFiles,
  });
  return updated;
}