feat: report remote gc target shortfall

scripts/src/help.ts

@@ -280,6 +280,7 @@ function gcHelp(): unknown {
       "bun scripts/cli.ts gc policy plan",
       "bun scripts/cli.ts gc policy install",
       "bun scripts/cli.ts gc remote G14 plan",
+      "bun scripts/cli.ts gc remote G14 plan --target-use-percent 50 --include-hwlab-registry",
       "bun scripts/cli.ts gc remote G14 run --confirm",
       "bun scripts/cli.ts gc remote G14 status --job-id <id>",
       "bun scripts/cli.ts gc plan --full",
@@ -306,6 +307,7 @@ function gcHelp(): unknown {
       "--registry-gc-only": "remote G14 only: run official registry garbage-collect without deleting additional tags; intended for interrupted registry retention recovery",
       "--registry-keep-per-repo N": "remote registry only: keep at least N newest tags per service repo; default 20, minimum 1",
       "--registry-min-age-hours N": "remote registry only: keep all tags newer than N hours; default 48, minimum 0",
+      "--target-use-percent N": "remote only: evaluate whether planned candidates can reduce root filesystem use to N%; reports required reclaim, projected use, shortfall and safe-stop decision",
       "--job-id ID": "remote status only: inspect a long-running remote gc job",
       "--limit N": "number of candidates returned and executed by run when --full is not set; default 50",
       "--result-limit N": "number of per-candidate run results returned when --full is not set; default 50",