Method opRenameFile

src/FileRise/Domain/McpCoreOpsService.php:1220–1272

* @param array $payload * @return array */

(McpOpsContext $ctx, array $payload)

     * @return array<string,mixed>
     */
    private static function opRenameFile(McpOpsContext $ctx, array $payload): array
    {
        return self::withSourceContext($ctx, $payload, true, function () use ($ctx, $payload): array {
            self::assertWritableAccount($ctx, false);

            $folder = self::normalizeFolder((string)($payload['folder'] ?? 'root'));
            $oldName = self::normalizeFileName((string)($payload['oldName'] ?? ($payload['old_name'] ?? '')));
            $newName = self::normalizeFileName((string)($payload['newName'] ?? ($payload['new_name'] ?? '')));
            if (strcasecmp($oldName, $newName) === 0) {
                throw new RuntimeException('Old and new file names are the same.', 400);
            }

            $username = $ctx->username();
            $perms = $ctx->permissions();

            $hasRename = ACL::canRename($username, $perms, $folder)
                || ACL::ownsFolderOrAncestor($username, $perms, $folder);
            if (!$hasRename) {
                throw new RuntimeException('Forbidden: no rename permission.', 403);
            }

            self::assertFolderScope($ctx, $folder, 'rename');

            if (
                !$ctx->canBypassOwnership()
                && !ACL::canRead($username, $perms, $folder)
                && ACL::hasGrant($username, $folder, 'read_own')
            ) {
                self::assertFilesOwnedByUser($folder, [$oldName], $username);
            }

            $result = FileModel::renameFile($folder, $oldName, $newName);
            if (!is_array($result)) {
                throw new RuntimeException('Failed to rename file.', 500);
            }
            if (isset($result['error'])) {
                throw new RuntimeException((string)$result['error'], 400);
            }

            $resolvedNewName = trim((string)($result['newName'] ?? $newName));
            if ($resolvedNewName === '') {
                $resolvedNewName = $newName;
            }

            return [
                'ok' => true,
                'folder' => $folder,
                'oldName' => $oldName,
                'newName' => $resolvedNewName,
                'result' => $result,
            ];
        });
    }

    /**
     * @param array<string,mixed> $payload