Documentation cleanup and bugfixes

internal/adapter/cli/run_test.go

@@ -155,8 +155,24 @@ func TestParseServeArgsRequiredFlags(t *testing.T) {
 	if cfg.addr != defaults.HTTPAddrDefault {
 		t.Fatalf("expected default addr %s, got %q", defaults.HTTPAddrDefault, cfg.addr)
 	}
-	if cfg.timeout != defaults.LLMRequestTimeoutDefault {
-		t.Fatalf("expected default timeout %s, got %s", defaults.LLMRequestTimeoutDefault, cfg.timeout)
+	if cfg.schemaDir != defaults.SchemaDirDefault {
+		t.Fatalf("expected default schema dir %q, got %q", defaults.SchemaDirDefault, cfg.schemaDir)
+	}
+}
+
+func TestParseServeArgsRejectsRuntimeOverrideFlags(t *testing.T) {
+	base := []string{"--prompt-dir", "./prompts", "--profile-dir", "./profiles"}
+	tests := [][]string{
+		{"--llm-base-url", "http://localhost:8000/v1"},
+		{"--model", "gpt-4o-mini"},
+		{"--timeout", "30s"},
+	}
+
+	for _, tc := range tests {
+		_, err := parseServeArgs(append(base, tc...))
+		if err == nil {
+			t.Fatalf("expected unknown flag error for %q", tc[0])
+		}
 	}
 }
 
@@ -213,7 +229,7 @@ func TestRunCommandVarsOptional(t *testing.T) {
 		"--profile-dir", "./profiles",
 		"--prompt", "p",
 		"--input", "transcript=./t.md",
-		"--llm-base-url", "://bad-url",
+		"--llm-base-url", "http://[::1",
 		"--model", "m",
 	}, &stdout, &stderr)
 
@@ -223,8 +239,8 @@ func TestRunCommandVarsOptional(t *testing.T) {
 	if strings.Contains(stderr.String(), "var parse error") {
 		t.Fatalf("expected --var to be optional, got stderr=%q", stderr.String())
 	}
-	if !strings.Contains(stderr.String(), "llm client error") {
-		t.Fatalf("expected llm client error after parsing succeeds, got stderr=%q", stderr.String())
+	if !strings.Contains(stderr.String(), "llm client error") && !strings.Contains(stderr.String(), "run error") {
+		t.Fatalf("expected post-parse execution error, got stderr=%q", stderr.String())
 	}
 	if stdout.Len() != 0 {
 		t.Fatalf("expected no stdout output on error, got %q", stdout.String())