docs: update docs a bit

Author: jippi

README.md

@@ -156,17 +156,53 @@ NAME:
    scm-engine evaluate - Evaluate a Merge Request
 
 USAGE:
-   scm-engine evaluate [command options]
+   scm-engine evaluate [command options] [id, id, ...]
 
 OPTIONS:
+   --project value                                                GitLab project (example: 'gitlab-org/gitlab') [$GITLAB_PROJECT, $CI_PROJECT_PATH]
    --id value, --merge-request-id value, --pull-request-id value  The pull/merge to process, if not provided as a CLI flag [$CI_MERGE_REQUEST_IID]
+   --help, -h                                                     show help
 
 GLOBAL OPTIONS:
    --config value     Path to the scm-engine config file (default: ".scm-engine.yml") [$SCM_ENGINE_CONFIG_FILE]
    --api-token value  GitHub/GitLab API token [$SCM_ENGINE_TOKEN]
-   --project value    GitLab project (example: 'gitlab-org/gitlab') [$GITLAB_PROJECT, $CI_PROJECT_PATH]
    --base-url value   Base URL for the SCM instance (default: "https://gitlab.com/") [$GITLAB_BASEURL, $CI_SERVER_URL]
+   --dry-run          Dry run, don't actually _do_ actions, just print them (default: false)
    --help, -h         show help
+   --version, -v      print the version
+```
+
+### `server`
+
+Point your GitLab webhook at the `/gitlab` endpoint.
+
+Support the following events, and they will both trigger an Merge Request `evaluation`
+
+- [`Comments`](https://docs.gitlab.com/ee/user/project/integrations/webhook_events.html#comment-events) - A comment is made or edited on an issue or merge request.
+- [`Merge request events`](https://docs.gitlab.com/ee/user/project/integrations/webhook_events.html#merge-request-events) - A merge request is created, updated, or merged.
+
+> [!TIP]
+> You have access to the raw webhook event payload via `webhook_event.*` fields in Expr script fields when using `server` mode. See the [GitLab Webhook Events documentation](https://docs.gitlab.com/ee/user/project/integrations/webhook_events.html) for available fields.
+
+```plain
+NAME:
+   scm-engine server - Start HTTP server for webhook event driven usage
+
+USAGE:
+   scm-engine server [command options]
+
+OPTIONS:
+   --webhook-secret value  Used to validate received payloads. Sent with the request in the X-Gitlab-Token HTTP header [$SCM_ENGINE_WEBHOOK_SECRET]
+   --listen value          Port the HTTP server should listen on (default: "0.0.0.0:3000") [$SCM_ENGINE_LISTEN]
+   --help, -h              show help
+
+GLOBAL OPTIONS:
+   --config value     Path to the scm-engine config file (default: ".scm-engine.yml") [$SCM_ENGINE_CONFIG_FILE]
+   --api-token value  GitHub/GitLab API token [$SCM_ENGINE_TOKEN]
+   --base-url value   Base URL for the SCM instance (default: "https://gitlab.com/") [$GITLAB_BASEURL, $CI_SERVER_URL]
+   --dry-run          Dry run, don't actually _do_ actions, just print them (default: false)
+   --help, -h         show help
+   --version, -v      print the version
 ```
 
 ## Configuration file

cmd/conventions.go

@@ -7,6 +7,6 @@ const (
 	FlagMergeRequestID = "id"
 	FlagSCMBaseURL     = "base-url"
 	FlagSCMProject     = "project"
-	FlagServerListen   = "listen-port"
+	FlagServerListen   = "listen"
 	FlagWebhookSecret  = "webhook-secret"
 )

main.go

@@ -76,9 +76,11 @@ func main() {
 		},
 		Commands: []*cli.Command{
 			{
-				Name:   "evaluate",
-				Usage:  "Evaluate a Merge Request",
-				Action: cmd.Evaluate,
+				Name:      "evaluate",
+				Usage:     "Evaluate a Merge Request",
+				Args:      true,
+				ArgsUsage: " [id, id, ...]",
+				Action:    cmd.Evaluate,
 				Flags: []cli.Flag{
 					&cli.StringFlag{
 						Name:     cmd.FlagSCMProject,