Add --help for Cli and selected tests

Author: MDA2AV

README.md

@@ -42,18 +42,25 @@ dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080
 
 | Flag | Description | Default |
 |------|-------------|---------|
-| `--host` | Target host | `localhost` |
-| `--port` | Target port | `8080` |
-| `--category` | Filter by category (`Compliance`, `Smuggling`, `MalformedInput`) | all |
-| `--timeout` | Connect/read timeout in seconds | `5` |
-| `--output` | Write JSON report to file | — |
+| `--host` | Target hostname or IP address | `localhost` |
+| `--port` | Target port number | `8080` |
+| `--category` | Run only tests in this category (`Compliance`, `Smuggling`, `MalformedInput`) | all |
+| `--test` | Run only specific test IDs, case-insensitive (repeatable) | all |
+| `--timeout` | Connect and read timeout in seconds per test | `5` |
+| `--output` | Write JSON results to file | — |
 
-### Example
+### Examples
 
 ```
 dotnet run --project src/Http11Probe.Cli -- --host localhost --port 8080 --output results.json
 ```
 
+Run specific tests:
+
+```
+dotnet run --project src/Http11Probe.Cli -- --test SMUG-CL-TE-BOTH --test SMUG-DUPLICATE-CL
+```
+
 Results stream to the console as each test completes, with a summary at the end:
 
 ```

src/Http11Probe.Cli/Program.cs

@@ -4,24 +4,27 @@
 using Http11Probe.TestCases;
 using Http11Probe.TestCases.Suites;
 
-var hostOption = new Option<string>("--host") { Description = "Target host" };
+var hostOption = new Option<string>("--host") { Description = "Target hostname or IP address" };
 hostOption.DefaultValueFactory = _ => "localhost";
 
-var portOption = new Option<int>("--port") { Description = "Target port" };
+var portOption = new Option<int>("--port") { Description = "Target port number" };
 portOption.DefaultValueFactory = _ => 8080;
 
-var categoryOption = new Option<TestCategory?>("--category") { Description = "Run only tests in this category" };
+var categoryOption = new Option<TestCategory?>("--category") { Description = "Run only tests in this category (skip all others)" };
 
-var timeoutOption = new Option<int>("--timeout") { Description = "Read/connect timeout in seconds" };
+var testOption = new Option<string[]>("--test") { Description = "Run only specific test IDs, case-insensitive (repeatable)", Arity = ArgumentArity.OneOrMore };
+
+var timeoutOption = new Option<int>("--timeout") { Description = "Connect and read timeout in seconds per test" };
 timeoutOption.DefaultValueFactory = _ => 5;
 
-var outputOption = new Option<string?>("--output") { Description = "Write JSON report to this file path" };
+var outputOption = new Option<string?>("--output") { Description = "Write JSON results to this file path" };
 
 var rootCommand = new RootCommand("Http11Probe — HTTP/1.1 server compliance & hardening tester")
 {
     hostOption,
     portOption,
     categoryOption,
+    testOption,
     timeoutOption,
     outputOption
 };
@@ -32,6 +35,7 @@
     var port = parseResult.GetValue(portOption);
     var category = parseResult.GetValue(categoryOption);
     var timeout = parseResult.GetValue(timeoutOption);
+    var testIds = parseResult.GetValue(testOption);
     var outputPath = parseResult.GetValue(outputOption);
 
     Console.WriteLine($"  Http11Probe targeting {host}:{port}");
@@ -43,7 +47,10 @@
         Port = port,
         ConnectTimeout = TimeSpan.FromSeconds(timeout),
         ReadTimeout = TimeSpan.FromSeconds(timeout),
-        CategoryFilter = category
+        CategoryFilter = category,
+        TestIdFilter = testIds is { Length: > 0 }
+            ? new HashSet<string>(testIds, StringComparer.OrdinalIgnoreCase)
+            : null
     };
 
     var testCases = ComplianceSuite.GetTestCases()

src/Http11Probe/Runner/TestRunOptions.cs

@@ -9,4 +9,5 @@ public sealed class TestRunOptions
     public TimeSpan ConnectTimeout { get; init; } = TimeSpan.FromSeconds(5);
     public TimeSpan ReadTimeout { get; init; } = TimeSpan.FromSeconds(5);
     public TestCategory? CategoryFilter { get; init; }
+    public HashSet<string>? TestIdFilter { get; init; }
 }

src/Http11Probe/Runner/TestRunner.cs

@@ -27,7 +27,8 @@ public async Task<TestRunReport> RunAsync(IEnumerable<TestCase> testCases, Actio
 
         foreach (var testCase in testCases)
         {
-            if (_options.CategoryFilter.HasValue && testCase.Category != _options.CategoryFilter.Value)
+            if (_options.CategoryFilter.HasValue && testCase.Category != _options.CategoryFilter.Value
+                || _options.TestIdFilter is { Count: > 0 } ids && !ids.Contains(testCase.Id))
             {
                 var skip = new TestResult
                 {

src/Servers/GlyphServer/Program.cs

@@ -8,7 +8,7 @@
 using Glyph11.Protocol;
 using Glyph11.Validation;
 
-var port = args.Length > 0 && int.TryParse(args[0], out var p) ? p : 5098;
+var port = args.Length > 0 && int.TryParse(args[0], out var p) ? p : 8080;
 
 var listener = new TcpListener(IPAddress.Any, port);
 listener.Start();