Fix

Author: dbpolito

commands/run_test.go

@@ -793,3 +793,60 @@ func TestNewRunCommandJsonOutput(t *testing.T) {
 		t.Errorf("unexpected scripts order or names: %v", output)
 	}
 }
+
+func TestNewRunCommandJsonOutputEmpty(t *testing.T) {
+	f := newFakeKoolRun(nil, nil)
+	f.parser.(*parser.FakeParser).MockScriptDetails = []parser.ScriptDetail{}
+
+	cmd := NewRunCommand(f)
+	cmd.SetArgs([]string{"--json"})
+
+	if err := cmd.Execute(); err != nil {
+		t.Errorf("unexpected error executing run command with --json; error: %v", err)
+	}
+
+	fakeShell := f.shell.(*shell.FakeShell)
+
+	if len(fakeShell.OutLines) == 0 {
+		t.Error("expected JSON output")
+		return
+	}
+
+	// Should output empty array, not null
+	if fakeShell.OutLines[0] != "[]" {
+		t.Errorf("expected empty JSON array '[]', got '%s'", fakeShell.OutLines[0])
+	}
+}
+
+func TestNewRunCommandJsonOutputNullSafety(t *testing.T) {
+	f := newFakeKoolRun(nil, nil)
+	f.parser.(*parser.FakeParser).MockScriptDetails = []parser.ScriptDetail{
+		{
+			Name:     "test",
+			Comments: nil, // nil comments
+			Commands: nil, // nil commands
+		},
+	}
+
+	cmd := NewRunCommand(f)
+	cmd.SetArgs([]string{"--json"})
+
+	if err := cmd.Execute(); err != nil {
+		t.Errorf("unexpected error executing run command with --json; error: %v", err)
+	}
+
+	fakeShell := f.shell.(*shell.FakeShell)
+
+	var output []parser.ScriptDetail
+	if err := json.Unmarshal([]byte(fakeShell.OutLines[0]), &output); err != nil {
+		t.Fatalf("failed to parse json output: %v", err)
+	}
+
+	// Verify nil values are converted to empty arrays
+	if output[0].Comments == nil {
+		t.Error("Comments should not be nil in JSON output")
+	}
+	if output[0].Commands == nil {
+		t.Error("Commands should not be nil in JSON output")
+	}
+}

docs/05-Commands-Reference/0-kool.md

@@ -34,9 +34,9 @@ kool
 * [kool recipe](kool-recipe)	 - Adds configuration for some recipe in the current work directory.
 * [kool restart](kool-restart)	 - Restart running service containers (the same as 'kool stop' followed by 'kool start')
 * [kool run](kool-run)	 - Execute a script defined in kool.yml
-* [kool scripts](kool-scripts)	 - List scripts defined in kool.yml
 * [kool self-update](kool-self-update)	 - Update kool to the latest version
 * [kool share](kool-share)	 - Live share your local environment on the Internet using an HTTP tunnel
 * [kool start](kool-start)	 - Start service containers defined in docker-compose.yml
 * [kool status](kool-status)	 - Show the status of all service containers
 * [kool stop](kool-stop)	 - Stop and destroy running service containers
+

docs/05-Commands-Reference/kool-run.md

@@ -16,6 +16,7 @@ kool run SCRIPT [--] [ARG...]
 ```
   -e, --env stringArray   Environment variables.
   -h, --help              help for run
+      --json              Output available scripts as JSON (use without script argument)
 ```
 
 ### Options inherited from parent commands