Flatten script suite case arrays

Author: SqlRush

docs/cc-100-roadmap.md

@@ -596,6 +596,8 @@ M7 补充：prompt history `LogEntry` 读取现在接受 `sessionID`/`session`/`
 
 本轮补充：interaction script key input 现在接受 press-style aliases，包括 `press`、`keyPress`、`keypress`、`shortcutKey`、`presses`、`keyPresses` 和 `shortcuts`。
 
+本轮补充：interaction script loader 现在会扁平化 `cases`/`tests`/`testCases`/`scenarios`/`fixtures` 等 suite array，每个 case 内的 `steps`/`timeline`/`scriptSteps` 会按顺序展开，顶层数组也可直接混入 case object。
+
 本轮补充：interaction script 的 key/keySequence action payload 现在递归解包 JSON:API/GraphQL-style wrapper，wrapped single key 和 key sequence array 可直接驱动按键输入与组合键事件。
 
 本轮补充：interaction script 的 direct key alias 字段现在也接受 wrapped object，`key`、`keyPress`、`keyPresses` 等字段可从 `resource.attributes` 或 `edge.node.attrs` 中恢复单键和 key sequence，避免官方 fixture 直接字段形态在 string/list decode 阶段失败。

docs/claude-code-go-rewrite-plan.md

@@ -324,6 +324,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：interaction script 的 per-step keybinding mutation 复用同一套 collection alias、object-map 和 resource wrapper 解析，脚本步骤可直接使用 `keymap`、`keyboardShortcuts`、`hotkeys`、`keyboard`、`preferences` 或 `keybindingConfig` 临时改键位。
 - 本轮补充：interaction script 的 `keys` 字段支持 printable text chunk 和空格分隔 named-key sequence，例如 `ctrl-x ctrl-k`，减少官方脚本把连续输入拆成数组的改写成本。
 - 本轮补充：interaction script key input 接受 press-style aliases，包括 `press`、`keyPress`、`keypress`、`shortcutKey`、`presses`、`keyPresses` 和 `shortcuts`。
+- 本轮补充：interaction script loader 现在会扁平化 `cases`/`tests`/`testCases`/`scenarios`/`fixtures` 等 suite array，每个 case 内的 `steps`/`timeline`/`scriptSteps` 会按顺序展开，顶层数组也可直接混入 case object。
 - 本轮补充：interaction script key/keySequence action payload 现在递归解包 JSON:API/GraphQL-style wrapper，`payload.resource.attributes.key` 和 `edge.node.attrs.sequence` 可直接驱动按键与组合键序列。
 - 本轮补充：interaction script 的直接字符串 alias 字段现在也接受 wrapped object；`text`、`pasteText`、`setStatus`、`snapshotName` 等字段可从 `resource.attributes` 或 `edge.node.attrs` 中恢复正文、paste、status 和 snapshot 名称，避免 direct field fixture 在 scalar decode 阶段失败。
 - 本轮补充：interaction script action/type/kind/name/operation 动作判别字段接受 compact/camel fixture aliases，包括 `typeText`、`inputText`、`insertText`、`keyPress`、`pressKey`、`keySequence`、`pasteText`、`pastedText`、`clipboardText`、`setStatus`、`statusLine`、`terminalSize` 和 `screenSize`。

docs/first-second-parity-audit.md

@@ -305,6 +305,7 @@ M7 progress now includes:
 - `internal/tui`: keybinding config and named-key script input now accept Shift-Tab terminfo aliases such as `backtab`, `back-tab`, and `btab`, mapping them to the existing focus-previous key surface.
 - `internal/tui`: scripted interaction `keys` entries now accept printable text chunks and whitespace-separated named key sequences such as `ctrl-x ctrl-k`.
 - `internal/tui`: scripted interaction key input now accepts press-style aliases such as `press`, `keyPress`, `keypress`, `shortcutKey`, `presses`, `keyPresses`, and `shortcuts`.
+- `internal/tui`: interaction script loading now flattens suite/case arrays such as `cases`, `tests`, `testCases`, `scenarios`, and `fixtures`, expanding nested `steps`, `timeline`, or `scriptSteps` arrays in order while still allowing top-level arrays to mix direct steps and case objects.
 - `internal/tui`: scripted key and key-sequence action payloads now recursively unwrap JSON:API/GraphQL-style wrappers, preserving wrapped single keys and key sequence arrays from API-shaped interaction fixtures.
 - `internal/tui`: direct scripted key alias fields such as `key`, `keyPress`, and `keyPresses` now accept JSON:API/GraphQL-style wrapper objects without failing strong string/list decoding.
 - `internal/tui`: direct scripted string alias fields such as `text`, `pasteText`, `setStatus`, and `snapshotName` now accept JSON:API/GraphQL-style wrapper objects without failing strong scalar decoding.

internal/tui/script_loader.go

@@ -26,8 +26,8 @@ func ParseInteractionScript(data []byte) ([]ScriptStep, error) {
 		return nil, nil
 	}
 	if data[0] == '[' {
-		var steps []ScriptStep
-		if err := json.Unmarshal(data, &steps); err != nil {
+		steps, err := parseInteractionScriptStepsValue(data)
+		if err != nil {
 			return nil, fmt.Errorf("parse interaction script array: %w", err)
 		}
 		return steps, nil
@@ -84,6 +84,17 @@ func parseInteractionScriptObject(data []byte) ([]ScriptStep, bool, error) {
 		"included",
 		"actions",
 		"timeline",
+		"tests",
+		"test_cases",
+		"testCases",
+		"cases",
+		"scenarios",
+		"fixtures",
+		"recordings",
+		"runs",
+		"operations",
+		"commands",
+		"plays",
 		"collection",
 		"collections",
 		"list",
@@ -183,13 +194,131 @@ func parseInteractionScriptStepsValue(value json.RawMessage) ([]ScriptStep, erro
 			return steps, nil
 		}
 	}
+	if len(value) > 0 && value[0] == '[' {
+		return parseInteractionScriptArrayValue(value)
+	}
 	var steps []ScriptStep
 	if err := json.Unmarshal(value, &steps); err != nil {
 		return nil, err
 	}
 	return steps, nil
 }
 
+func parseInteractionScriptArrayValue(value json.RawMessage) ([]ScriptStep, error) {
+	var items []json.RawMessage
+	if err := json.Unmarshal(value, &items); err != nil {
+		return nil, err
+	}
+	steps := make([]ScriptStep, 0, len(items))
+	for index, item := range items {
+		item = bytes.TrimSpace(item)
+		if len(item) == 0 || bytes.Equal(item, []byte("null")) {
+			continue
+		}
+		if item[0] == '{' && interactionScriptObjectHasContainer(item) {
+			nested, ok, err := parseInteractionScriptObject(item)
+			if err != nil {
+				return nil, fmt.Errorf("item %d: %w", index, err)
+			}
+			if ok {
+				steps = append(steps, nested...)
+				continue
+			}
+		}
+		var step ScriptStep
+		if err := json.Unmarshal(item, &step); err != nil {
+			return nil, fmt.Errorf("item %d: %w", index, err)
+		}
+		steps = append(steps, step)
+	}
+	return steps, nil
+}
+
+func interactionScriptObjectHasContainer(data []byte) bool {
+	fields := map[string]json.RawMessage{}
+	if err := json.Unmarshal(data, &fields); err != nil {
+		return false
+	}
+	for _, name := range []string{
+		"steps",
+		"script",
+		"script_steps",
+		"scriptSteps",
+		"interaction_script",
+		"interactionScript",
+		"interaction_steps",
+		"interactionSteps",
+		"records",
+		"recorded_steps",
+		"recordedSteps",
+		"events",
+		"entries",
+		"items",
+		"included",
+		"actions",
+		"timeline",
+		"tests",
+		"test_cases",
+		"testCases",
+		"cases",
+		"scenarios",
+		"fixtures",
+		"recordings",
+		"runs",
+		"operations",
+		"commands",
+		"plays",
+	} {
+		raw, ok := fields[name]
+		if !ok {
+			continue
+		}
+		raw = bytes.TrimSpace(raw)
+		if len(raw) > 0 && (raw[0] == '{' || raw[0] == '[') {
+			return true
+		}
+	}
+	if scriptStepJSONHasDirectFields(fields) {
+		return false
+	}
+	for _, name := range []string{
+		"scenario",
+		"test",
+		"case",
+		"fixture",
+		"interaction",
+		"viewer",
+		"connection",
+		"stepConnection",
+		"stepsConnection",
+		"interactionConnection",
+		"recordingConnection",
+		"recording",
+		"session",
+		"run",
+	} {
+		raw, ok := fields[name]
+		if !ok {
+			continue
+		}
+		raw = bytes.TrimSpace(raw)
+		if len(raw) > 0 && raw[0] == '{' {
+			return true
+		}
+	}
+	for _, name := range []string{"data", "payload", "body", "result", "response"} {
+		raw, ok := fields[name]
+		if !ok {
+			continue
+		}
+		raw = bytes.TrimSpace(raw)
+		if len(raw) > 0 && raw[0] == '{' && interactionScriptObjectHasContainer(raw) {
+			return true
+		}
+	}
+	return false
+}
+
 func parseInteractionScriptOptionalStepsValue(value json.RawMessage) ([]ScriptStep, bool, error) {
 	value = bytes.TrimSpace(value)
 	if len(value) == 0 || bytes.Equal(value, []byte("null")) {

internal/tui/tui_test.go

@@ -8614,6 +8614,53 @@ func TestParseInteractionScriptAcceptsWrapperObjects(t *testing.T) {
 	}
 }
 
+func TestParseInteractionScriptAcceptsSuiteCaseArrays(t *testing.T) {
+	for name, script := range map[string]string{
+		"cases": `{"cases":[
+			{"name":"case-one","steps":[
+				{"action":"type","value":"go"},
+				{"type":"press","value":"enter","expectEvent":{"type":"prompt_submitted","value":"go"}}
+			]}
+		]}`,
+		"data_test_cases": `{"data":{"testCases":[
+			{"id":"test-1","scenario":{"timeline":[
+				{"action":"type","value":"ship"},
+				{"type":"press","value":"enter","expectEvent":{"type":"prompt_submitted","value":"ship"}}
+			]}}
+		]}}`,
+		"scenarios": `{"scenarios":[
+			{"fixture":{"scriptSteps":[
+				{"action":"type","value":"audit"},
+				{"type":"press","value":"enter","expectEvent":{"type":"prompt_submitted","value":"audit"}}
+			]}}
+		]}`,
+		"top_level_case_array": `[
+			{"name":"array-case","steps":[
+				{"action":"type","value":"run"},
+				{"type":"press","value":"enter","expectEvent":{"type":"prompt_submitted","value":"run"}}
+			]}
+		]`,
+	} {
+		t.Run(name, func(t *testing.T) {
+			steps, err := ParseInteractionScript([]byte(script))
+			if err != nil {
+				t.Fatal(err)
+			}
+			if len(steps) != 2 {
+				t.Fatalf("steps = %#v", steps)
+			}
+			screen := NewREPLScreen(30, 6, nil)
+			result, err := RunInteractionScriptChecked(&screen, steps)
+			if err != nil {
+				t.Fatal(err)
+			}
+			if len(result.Events) != 1 || result.Events[0].Type != ScreenEventPromptSubmitted {
+				t.Fatalf("events = %#v", result.Events)
+			}
+		})
+	}
+}
+
 func TestParseInteractionScriptAcceptsStepRecordWrappers(t *testing.T) {
 	for name, script := range map[string]string{
 		"array": `[