Accept press-style script key aliases

Author: SqlRush

docs/cc-100-roadmap.md

@@ -146,6 +146,8 @@ M7 补充：keybinding config 和脚本 named-key 输入现在接受短修饰符
 
 M7 补充：interaction script 的 `keys` 字段现在支持 printable text chunk 和空格分隔 named-key sequence，例如 `ctrl-x ctrl-k`，减少官方脚本把连续输入拆成数组的改写成本。
 
+M7 补充：interaction script key input 现在接受 press-style aliases，包括 `press`、`keyPress`、`keypress`、`shortcutKey`、`presses`、`keyPresses` 和 `shortcuts`。
+
 M7 补充：interaction script 的 `message` step 现在接受 chat/transcript 风格的 `type`/`speaker` role 别名和 `content`/`body`/`message` text 别名；`image` step 和 iTerm2 image hint 接受 `fileName`/`file_name`/`name`、`mimeType`/`mime_type`/`contentType`、source path/URL 和 `data`/`base64` 内容别名；permission request step 接受 request/permission/tool-use ID、path、description 和 action 字段别名，并允许 `actions` 使用单字符串；`expectPrompt` 接受 `value`/`input`/`content`/`message`、`expandedText`/`fullText`、`cursorIndex`/`cursorPosition`、`isEmpty`/`blank` 等字段别名，且 `pastedContents` 断言接受 `pastedId`/`pastedContentId`、`kind`/`pastedType`、`value`/`data`/`base64`、`contentType`/`mimeType`、`fileName`/`name` 和 `contains` 等字段别名；`expectVim` 接受 `vimEnabled`/`isEnabled`、`vimMode`/`modeName`/`currentMode`、`vimRegister`/`registerValue`/`yankRegister`、`registerLinewise`/`linewise` 等字段别名；`expectTasks` 接受 `taskCount`/`total`/`size`/`length` 和 `statusCounts`/`countsByState` 等字段别名；`expectScreen`/`expectViewport` 接受 `columns`/`rows`、`screenWidth`/`screenHeight`、`scrollOffset`/`viewportOffset`、`visibleRows`/`lineCount` 等字段别名；`expectReverseSearch` 接受 `isActive`/`visible`/`open`、`search`/`term`/`pattern`、`cursorIndex`、`currentResult`、`matchCount`/`matches`、`noMatches` 等字段别名；`expectDialog` 可断言 body contains/not-contains、actions/action contains/not-contains、action count 和 focused action，runtime-aware scripts 会在步骤间保留 dialog focused action，且接受 `isActive`/`visible`、`dialogId`/`dialogID`、`dialogKind`、`heading`/`header`、`content`/`text`/`message` 等字段别名；`expectEvent`/`expectDialogResult` 接受 `eventType`/`event`/`name`、`payload`/`text`/`message`、`dialogId`/`dialogID`/`dialogKind`、`actionValue`/`resultStatus`/`exists`/`isStale` 等字段别名。
 
 M7 补充：interaction script 现在接受 `messages`、`append_messages`/`appendMessages`、`transcript_messages`/`transcriptMessages` 批量消息注入字段，且这些字段既可用单个对象也可用对象数组，消息对象沿用 chat/transcript role/text 别名；message 注入也接受 `pastedContent`/`attachments` 粘贴内容别名、单数 `imagePasteId` 图片引用别名，以及 pasted-content 的 `kind`/`value`/`data` 内容字段别名。
@@ -428,6 +430,8 @@ M7 补充：prompt history `LogEntry` 读取现在接受 `sessionID`/`session`/`
 
 本轮补充：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 step 接受 `resize`/`terminalSize`/`screenSize` 对象或 `[width,height]` 数组、顶层 `columns`/`rows` resize 别名、`focus`/`focused`/`blur`/`focusIn`/`focusOut` focus event 别名、`snapshot`/`snapshotId`/`snapshotLabel` capture 名称别名，以及 runtime-aware mutation 别名如 `permission`/`permissionRequest`、`task`/`taskStatus`、`removeTask`/`deleteTask`、`cancelPermission`、`cancelTasks`/`cancelReason`、`openTasks`/`showTasks`。
 
 本轮补充：interaction script step 可通过 `status`/`setStatus`/`statusLine`/`baseStatus` 设置状态行；runtime-aware scripts 会把它作为 base status，并继续叠加 permission/task 计数，便于复用带状态栏的 ANSI/interaction fixture。

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

@@ -261,6 +261,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：keybinding action parser 接受更多 editor-style action aliases，包括 `cursorLeft`/`cursorRight`、`lineStart`/`lineEnd`、`deletePreviousChar`/`deleteNextChar`、`killLine`、`acceptSelection` 和 `search`。
 - 本轮补充：keybinding config 和脚本 named-key 输入接受短修饰符别名，包括 `c-`/`m-`/`a-`/`opt-`/`s-` 以及 compact/camel 形式，可覆盖 control、meta、alt、option 和 shift key names。
 - 本轮补充：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`。
 - 本轮补充：terminal CSI-u/kitty keyboard parser 接受 `codepoint:alternate` 和 `modifier:event-type` 冒号字段，按主 codepoint/modifier 解析 ctrl/alt/shift/rune 键，覆盖 kitty progressive keyboard protocol 的常见变体。
 - 本轮补充：terminal CSI-u/kitty keyboard parser 接受无 modifier 字段或 modifier `1` 的 base key 序列，覆盖 printable rune、Enter、Tab、Esc 和 Backspace，避免 extended-key 模式下普通键序列被解析成 unknown。
 - 本轮补充：terminal CSI parser 把 DA/device attributes (`CSI c`、`CSI >c`、`CSI =c`) 归入 report action，并在 terminal parser dispatcher 中作为 `TerminalActionReport` 暴露。

docs/first-second-parity-audit.md

@@ -243,6 +243,7 @@ M7 progress now includes:
 - `internal/tui`: keybinding action parsing now accepts broader editor-style aliases such as `cursorLeft`, `lineStart`, `deletePreviousChar`, `killLine`, `acceptSelection`, and `search`.
 - `internal/tui`: keybinding config and named-key script input now accept short modifier aliases such as `c-left`, `cA`, `m-b`, `a-right`, `optF`, `s-tab`, and `sEnter`.
 - `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`: terminal key parsing now accepts CSI-u/kitty keyboard protocol sequences for existing ctrl/alt editing keys, shift-enter, shift-tab, and printable shift-only runes.
 - `internal/tui`: terminal CSI-u/kitty keyboard parsing now also accepts colon-suffixed alternate codepoint and modifier event-type fields such as `CSI 97:65;5:1u`.
 - `internal/tui`: terminal CSI-u/kitty keyboard parsing now also accepts base/unmodified sequences such as `CSI 97u` and `CSI 13;1u`, mapping printable runes plus Enter, Tab, Esc, and Backspace instead of treating ordinary extended-key reports as unknown.

internal/tui/script_aliases.go

@@ -211,6 +211,20 @@ func (step *ScriptStep) UnmarshalJSON(data []byte) error {
 		RawKeyCamel               *string                   `json:"rawKey"`
 		KeySequence               *string                   `json:"key_sequence"`
 		KeySequenceCamel          *string                   `json:"keySequence"`
+		Press                     *string                   `json:"press"`
+		PressKey                  *string                   `json:"press_key"`
+		PressKeyCamel             *string                   `json:"pressKey"`
+		KeyPress                  *string                   `json:"key_press"`
+		KeyPressCamel             *string                   `json:"keyPress"`
+		Keypress                  *string                   `json:"keypress"`
+		Shortcut                  *string                   `json:"shortcut"`
+		ShortcutKey               *string                   `json:"shortcut_key"`
+		ShortcutKeyCamel          *string                   `json:"shortcutKey"`
+		Presses                   []string                  `json:"presses"`
+		KeyPresses                []string                  `json:"key_presses"`
+		KeyPressesCamel           []string                  `json:"keyPresses"`
+		Keypresses                []string                  `json:"keypresses"`
+		Shortcuts                 []string                  `json:"shortcuts"`
 		Input                     *string                   `json:"input"`
 		InputText                 *string                   `json:"input_text"`
 		InputTextCamel            *string                   `json:"inputText"`
@@ -371,6 +385,48 @@ func (step *ScriptStep) UnmarshalJSON(data []byte) error {
 	if fields.KeySequenceCamel != nil {
 		step.Key = *fields.KeySequenceCamel
 	}
+	if fields.Press != nil {
+		step.Key = *fields.Press
+	}
+	if fields.PressKey != nil {
+		step.Key = *fields.PressKey
+	}
+	if fields.PressKeyCamel != nil {
+		step.Key = *fields.PressKeyCamel
+	}
+	if fields.KeyPress != nil {
+		step.Key = *fields.KeyPress
+	}
+	if fields.KeyPressCamel != nil {
+		step.Key = *fields.KeyPressCamel
+	}
+	if fields.Keypress != nil {
+		step.Key = *fields.Keypress
+	}
+	if fields.Shortcut != nil {
+		step.Key = *fields.Shortcut
+	}
+	if fields.ShortcutKey != nil {
+		step.Key = *fields.ShortcutKey
+	}
+	if fields.ShortcutKeyCamel != nil {
+		step.Key = *fields.ShortcutKeyCamel
+	}
+	if fields.Presses != nil {
+		step.Keys = append(step.Keys, fields.Presses...)
+	}
+	if fields.KeyPresses != nil {
+		step.Keys = append(step.Keys, fields.KeyPresses...)
+	}
+	if fields.KeyPressesCamel != nil {
+		step.Keys = append(step.Keys, fields.KeyPressesCamel...)
+	}
+	if fields.Keypresses != nil {
+		step.Keys = append(step.Keys, fields.Keypresses...)
+	}
+	if fields.Shortcuts != nil {
+		step.Keys = append(step.Keys, fields.Shortcuts...)
+	}
 	if fields.Input != nil {
 		step.Text = *fields.Input
 	}
@@ -794,6 +850,11 @@ func (step *ScriptStep) UnmarshalJSON(data []byte) error {
 func normalizeScriptStepJSON(data []byte) []byte {
 	data = normalizeStringFieldsToArray(data,
 		"keys",
+		"presses",
+		"key_presses",
+		"keyPresses",
+		"keypresses",
+		"shortcuts",
 		"expect_status_contains",
 		"expectStatusContains",
 		"expect_status_not_contains",

internal/tui/tui_test.go

@@ -4895,6 +4895,32 @@ func TestRunInteractionScriptAcceptsKeysStringSequences(t *testing.T) {
 	}
 }
 
+func TestRunInteractionScriptAcceptsPressFieldAliases(t *testing.T) {
+	steps, err := ParseInteractionScript([]byte(`[
+		{"press":"a","expectPrompt":{"text":"a"}},
+		{"keyPress":"b","expectPrompt":{"text":"ab"}},
+		{"shortcutKey":"enter","expectEvent":{"type":"prompt_submitted","value":"ab"},"expectPrompt":{"empty":true}},
+		{"keyPresses":"ctrl-x ctrl-k","expectEvent":{"type":"kill_agents"}},
+		{"shortcuts":["o","k","enter"],"expectEvent":{"type":"prompt_submitted","value":"ok"},"expectPrompt":{"empty":true}},
+		{"presses":["y","enter"],"expectEvent":{"type":"prompt_submitted","value":"y"},"expectPrompt":{"empty":true}}
+	]`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	screen := NewREPLScreen(40, 8, nil)
+	result, err := RunInteractionScriptChecked(&screen, steps)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if len(result.Events) != 4 ||
+		result.Events[0].Type != ScreenEventPromptSubmitted || result.Events[0].Value != "ab" ||
+		result.Events[1].Type != ScreenEventKillAgents ||
+		result.Events[2].Type != ScreenEventPromptSubmitted || result.Events[2].Value != "ok" ||
+		result.Events[3].Type != ScreenEventPromptSubmitted || result.Events[3].Value != "y" {
+		t.Fatalf("events = %#v", result.Events)
+	}
+}
+
 func TestRunInteractionScriptAppliesStepKeybindings(t *testing.T) {
 	steps, err := ParseInteractionScript([]byte(`[
 		{"keybindings":{"keys":"ctrl-r","command":"submitPrompt"}},