Method opCreateFile

src/FileRise/Domain/McpCoreOpsService.php:768–808

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

(McpOpsContext $ctx, array $payload)

     * @return array<string,mixed>
     */
    private static function opCreateFile(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'));
            $fileName = self::normalizeFileName(
                (string)($payload['name'] ?? ($payload['file'] ?? ($payload['filename'] ?? '')))
            );

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

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

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

            $result = FileModel::createFile($folder, $fileName, $username);
            if (!is_array($result)) {
                throw new RuntimeException('Failed to create file.', 500);
            }
            if (empty($result['success'])) {
                $status = (int)($result['code'] ?? 400);
                if ($status < 400 || $status > 599) {
                    $status = 400;
                }
                throw new RuntimeException((string)($result['error'] ?? 'Failed to create file.'), $status);
            }

            return [
                'ok' => true,
                'folder' => $folder,
                'file' => $fileName,
                'result' => $result,
            ];
        });
    }

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