feat: interactive prompt support for bootstrap steps

Author: klaidliadon

config/config.go

@@ -18,10 +18,11 @@ type Config struct {
 }
 
 type BootstrapStep struct {
-	Name  string `yaml:"name"`
-	Dir   string `yaml:"dir"`
-	Check string `yaml:"check"`
-	Run   string `yaml:"run"`
+	Name   string `yaml:"name"`
+	Dir    string `yaml:"dir"`
+	Check  string `yaml:"check"`
+	Run    string `yaml:"run"`
+	Prompt string `yaml:"prompt"`
 }
 
 type Dep struct {

engine/bootstrap.go

@@ -1,8 +1,15 @@
 package engine
 
 import (
+	"bufio"
 	"context"
 	"fmt"
+	"io"
+	"log/slog"
+	"os"
+	"path/filepath"
+
+	"golang.org/x/term"
 
 	"github.com/warriorscode/deck/config"
 )
@@ -14,13 +21,71 @@ func RunBootstrap(ctx context.Context, dir string, steps []config.BootstrapStep,
 		if CheckShell(ctx, d, step.Check, env) {
 			continue
 		}
-		if err := RunShell(ctx, d, step.Run, env); err != nil {
+		stepEnv := env
+		if step.Prompt != "" {
+			extra, err := handlePrompt(step)
+			if err != nil {
+				return fmt.Errorf("bootstrap %q: %w", step.Name, err)
+			}
+			stepEnv = append(append([]string{}, env...), extra...)
+		}
+		if err := RunShell(ctx, d, step.Run, stepEnv); err != nil {
 			return fmt.Errorf("bootstrap %q: %w", step.Name, err)
 		}
 	}
 	return nil
 }
 
+// handlePrompt displays the prompt, reads multi-line input, writes it to a temp file,
+// and returns env vars pointing to the input.
+func handlePrompt(step config.BootstrapStep) ([]string, error) {
+	if !term.IsTerminal(int(os.Stdin.Fd())) {
+		slog.Warn("bootstrap prompt skipped (not a terminal)", "step", step.Name)
+		return nil, fmt.Errorf("prompt requires an interactive terminal")
+	}
+
+	fmt.Fprintf(os.Stderr, "\n%s\n", step.Prompt)
+
+	input, err := readMultiLine(os.Stdin)
+	if err != nil {
+		return nil, fmt.Errorf("reading input: %w", err)
+	}
+
+	tmpFile, err := os.CreateTemp("", "deck-prompt-*")
+	if err != nil {
+		return nil, fmt.Errorf("creating temp file: %w", err)
+	}
+	if _, err := tmpFile.WriteString(input); err != nil {
+		tmpFile.Close()
+		os.Remove(tmpFile.Name())
+		return nil, fmt.Errorf("writing temp file: %w", err)
+	}
+	tmpFile.Close()
+
+	absPath, _ := filepath.Abs(tmpFile.Name())
+	return []string{
+		"DECK_INPUT=" + input,
+		"DECK_INPUT_FILE=" + absPath,
+	}, nil
+}
+
+// readMultiLine reads lines until an empty line or EOF.
+func readMultiLine(r io.Reader) (string, error) {
+	scanner := bufio.NewScanner(r)
+	var result string
+	for scanner.Scan() {
+		line := scanner.Text()
+		if line == "" {
+			break
+		}
+		if result != "" {
+			result += "\n"
+		}
+		result += line
+	}
+	return result, scanner.Err()
+}
+
 func stepDir(base, override string) string {
 	if override != "" {
 		return override

engine/bootstrap_test.go

@@ -4,8 +4,10 @@ import (
 	"context"
 	"os"
 	"path/filepath"
+	"strings"
 	"testing"
 
+	"github.com/stretchr/testify/assert"
 	"github.com/stretchr/testify/require"
 
 	"github.com/warriorscode/deck/config"
@@ -45,3 +47,33 @@ func TestBootstrapFailFast(t *testing.T) {
 	_, err = os.Stat(marker)
 	require.True(t, os.IsNotExist(err))
 }
+
+func TestReadMultiLine(t *testing.T) {
+	input := "line one\nline two\nline three\n\nignored"
+	result, err := readMultiLine(strings.NewReader(input))
+	require.NoError(t, err)
+	assert.Equal(t, "line one\nline two\nline three", result)
+}
+
+func TestReadMultiLineEOF(t *testing.T) {
+	input := "single line"
+	result, err := readMultiLine(strings.NewReader(input))
+	require.NoError(t, err)
+	assert.Equal(t, "single line", result)
+}
+
+func TestReadMultiLineEmpty(t *testing.T) {
+	result, err := readMultiLine(strings.NewReader("\n"))
+	require.NoError(t, err)
+	assert.Equal(t, "", result)
+}
+
+func TestBootstrapPromptSkipsInNonTTY(t *testing.T) {
+	steps := []config.BootstrapStep{
+		{Name: "Needs input", Check: "false", Prompt: "Paste key:", Run: "true"},
+	}
+	// CI/test stdin is not a TTY, so prompt should fail gracefully.
+	err := RunBootstrap(context.Background(), ".", steps, nil)
+	require.Error(t, err)
+	assert.Contains(t, err.Error(), "interactive terminal")
+}

go.mod

@@ -205,6 +205,7 @@ require (
 	golang.org/x/mod v0.34.0 // indirect
 	golang.org/x/sync v0.20.0 // indirect
 	golang.org/x/sys v0.42.0 // indirect
+	golang.org/x/term v0.41.0 // indirect
 	golang.org/x/text v0.34.0 // indirect
 	golang.org/x/tools v0.43.0 // indirect
 	google.golang.org/protobuf v1.36.8 // indirect

go.sum

@@ -806,6 +806,8 @@ golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
 golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo=
 golang.org/x/term v0.12.0/go.mod h1:owVbMEjm3cBLCHdkQu9b1opXd4ETQWc3BhuQGKgXgvU=
 golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U=
+golang.org/x/term v0.41.0 h1:QCgPso/Q3RTJx2Th4bDLqML4W6iJiaXFq2/ftQF13YU=
+golang.org/x/term v0.41.0/go.mod h1:3pfBgksrReYfZ5lvYM0kSO0LIkAl4Yl2bXOkKP7Ec2A=
 golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
 golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=