Rename --pid flag to --frankenphp-pid

Author: alexandre-daubois

docs/caddy-configuration.md

@@ -43,10 +43,10 @@ Ember automatically detects FrankenPHP by sending `GET /frankenphp/threads` to t
 If auto-detection does not work, you can specify the process ID manually:
 
 ```bash
-ember --pid 12345
+ember --frankenphp-pid 12345
 ```
 
-When no `--pid` is provided, Ember scans the process list for a FrankenPHP process. If none is found, it falls back to scanning for a Caddy process for CPU/RSS monitoring. When process scanning is unavailable, Ember derives CPU and RSS from the standard Go `process_*` Prometheus metrics exposed by Caddy's `/metrics` endpoint.
+When no `--frankenphp-pid` is provided, Ember scans the process list for a FrankenPHP process. If none is found, it falls back to scanning for a Caddy process for CPU/RSS monitoring. When process scanning is unavailable, Ember derives CPU and RSS from the standard Go `process_*` Prometheus metrics exposed by Caddy's `/metrics` endpoint.
 
 ## Remote Caddy Instances
 

docs/cli-reference.md

@@ -13,7 +13,7 @@ ember [flags]
 | `--addr` | string | `http://localhost:2019` | Caddy admin API address |
 | `--interval` | duration | `1s` | Polling interval |
 | `--slow-threshold` | int | `500` | Slow request threshold in milliseconds. Requests above this are highlighted yellow; above 2x are red. |
-| `--pid` | int | `0` (auto) | FrankenPHP PID. Auto-detected if not set. |
+| `--frankenphp-pid` | int | `0` (auto) | FrankenPHP PID. Auto-detected if not set. |
 | `--json` | bool | `false` | JSON output mode (streaming JSONL). See [JSON Output](json-output.md). |
 | `--once` | bool | `false` | Output a single snapshot and exit. Requires `--json`. See [JSON Output](json-output.md). |
 | `--expose` | string | _(none)_ | Start Prometheus metrics endpoint on this address (e.g. `:9191`). See [Prometheus Export](prometheus-export.md). |
@@ -53,7 +53,7 @@ ember --slow-threshold 200
 ember --expose :9191 --metrics-prefix myapp
 
 # Explicitly specify a FrankenPHP PID
-ember --pid 42
+ember --frankenphp-pid 42
 ```
 
 ## Subcommands
@@ -90,7 +90,7 @@ ember status --addr http://prod:2019
 ember status --interval 2s
 ```
 
-The `--addr`, `--interval`, and `--pid` flags are available.
+The `--addr`, `--interval`, and `--frankenphp-pid` flags are available.
 
 ## Keybindings
 

docs/frankenphp-dashboard.md

@@ -2,7 +2,7 @@
 
 The FrankenPHP tab appears when Ember detects a FrankenPHP server. It provides per-thread introspection, worker management, and memory tracking.
 
-> **Note:** If the FrankenPHP tab does not appear, Ember could not reach the `/frankenphp/threads` admin API endpoint. Use `--pid` to specify the process manually, or verify that the admin API is accessible. See [Caddy Configuration](caddy-configuration.md).
+> **Note:** If the FrankenPHP tab does not appear, Ember could not reach the `/frankenphp/threads` admin API endpoint. Use `--frankenphp-pid` to specify the process manually, or verify that the admin API is accessible. See [Caddy Configuration](caddy-configuration.md).
 
 ## Dashboard Header
 

internal/app/run.go

@@ -19,7 +19,7 @@ type config struct {
 	noColor       bool
 	jsonMode      bool
 	once          bool
-	pid           int
+	frankenphpPID int
 	expose        string
 	daemon        bool
 	metricsPrefix string
@@ -66,7 +66,7 @@ Keybindings:
 			ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
 			defer cancel()
 
-			pid := int32(cfg.pid)
+			pid := int32(cfg.frankenphpPID)
 			if pid == 0 {
 				detected, err := fetcher.FindFrankenPHPProcess(ctx)
 				if err != nil {
@@ -99,7 +99,7 @@ Keybindings:
 	pf := cmd.PersistentFlags()
 	pf.StringVar(&cfg.addr, "addr", "http://localhost:2019", "Caddy admin API address")
 	pf.DurationVar(&cfg.interval, "interval", 1*time.Second, "Polling interval")
-	pf.IntVar(&cfg.pid, "pid", 0, "FrankenPHP PID (auto-detected if not set)")
+	pf.IntVar(&cfg.frankenphpPID, "frankenphp-pid", 0, "FrankenPHP PID (auto-detected if not set)")
 
 	f := cmd.Flags()
 	f.IntVar(&cfg.slowThreshold, "slow-threshold", 500, "Slow request threshold in ms")

internal/app/status.go

@@ -32,7 +32,7 @@ Exit code 0 means Caddy is reachable, 1 means unreachable.`,
 			ctx, cancel := signal.NotifyContext(context.Background(), os.Interrupt, syscall.SIGTERM)
 			defer cancel()
 
-			pid := int32(cfg.pid)
+			pid := int32(cfg.frankenphpPID)
 			if pid == 0 {
 				detected, err := fetcher.FindFrankenPHPProcess(ctx)
 				if err != nil {