Parse modified SS3 navigation keys

Author: SqlRush

docs/cc-100-roadmap.md

@@ -218,6 +218,8 @@ M7 补充：keybinding resolver/config 和脚本 named-key 输入已覆盖 `ctrl
 
 M7 补充：terminal input parser 现在把 modified SS3 function-key 序列（如 `ESC O 1;2P`、`ESC O 1;5Q`、`ESC O 1;16S`）归一为现有 F1-F4 key surface，补齐 xterm/kitty 兼容模式下的 F-key 输入形态。
 
+M7 补充：terminal input parser 现在也接受 modified SS3 application-cursor navigation 序列（如 `ESC O 1;2A`、`ESC O 1;5D`、`ESC O 1;16C`），和 CSI modified navigation 一样把 shift 降级为方向键、alt/meta 映射到 word-motion key、ctrl 组合映射到 ctrl word-motion key。
+
 M7 补充：terminal input parser 现在把显式默认参数的 CSI navigation key 序列（如 `ESC [ 1 A`、`ESC [ 1 D`、`ESC [ 1 H`、`ESC [ 1 F`）归一为现有 arrow/Home/End key surface，同时继续让 `ESC [ 2 A` 这类 cursor-count 控制保持 unknown。
 
 M7 补充：task runtime 现在会在状态行、任务面板排序/渲染、批量取消和 scripted task expectation 前把 `active`/`in_progress`、`success`/`done`、`error`、`canceled` 等 task state 别名归一为 canonical 状态。

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

@@ -367,6 +367,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：scripted interaction assertion/check 数组元素的载荷现在也接受 `resource`/`node`/`attributes`/`properties`/`result`/`response`/`output`，让 JSON:API/resource-style 断言体可直接映射到 prompt/event/dialog/snapshot/screen/task/vim/viewport expectation。
 - 本轮补充：keybinding config、keymap 解析和 interaction script named-key 输入接受 `ctrl-h`/`ctrl-i`/`ctrl-j`/`ctrl-m`、`ctrl-[`、`ctrl-?`、对应 `control-*` 以及 compact/camel 形式；terminal parser 支持 CSI-u/kitty keyboard protocol 的 ctrl/alt/shift-enter/shift-tab 序列；image hint parser 支持 OSC ST terminator 和 base64 `name=` filename；keybinding JSON loader 支持 wrapper object-map、`shortcuts`、object action 字段、string-array key sequence/chord 和 `null`/`false` unbind；mouse parser 支持 legacy X10/normal tracking 序列；interaction script 支持结构化 mouse/mouse_event 步骤，button 接受 `buttonMask`/`button_mask`/`btn`/`code`/`mask`，坐标接受 `mouseX`/`mouse_x`/`clientX`/`screenX`/`pageX`/`offsetX`/`viewportX` 和对应 Y/row/line 别名，release 接受 `mouseUp`/`isRelease`/`mouseRelease`/`releaseEvent` 等字段别名；interaction script 还支持字符串 `keys` 和 `input`/`input_text`/`keys_text`/`raw_key`/`paste_text` 字段别名，并允许 status/snapshot/viewport/pasted-content contains 断言使用单字符串或字符串数组，`keybindings`、`expectEvents`、`expectDialogResults`、`expectPrompt.pastedContents` 和 `expectTasks.contains` 使用单对象或对象数组。
 - 本轮补充：terminal input parser 现在把 modified SS3 function-key 序列（如 `ESC O 1;2P`、`ESC O 1;5Q`、`ESC O 1;16S`）归一为现有 F1-F4 key surface，补齐 xterm/kitty 兼容模式下的 F-key 输入形态。
+- 本轮补充：terminal input parser 现在也接受 modified SS3 application-cursor navigation 序列（如 `ESC O 1;2A`、`ESC O 1;5D`、`ESC O 1;16C`），和 CSI modified navigation 一样把 shift 降级为方向键、alt/meta 映射到 word-motion key、ctrl 组合映射到 ctrl word-motion key。
 - 本轮补充：terminal input parser 现在把显式默认参数的 CSI navigation key 序列（如 `ESC [ 1 A`、`ESC [ 1 D`、`ESC [ 1 H`、`ESC [ 1 F`）归一为现有 arrow/Home/End key surface，同时继续让 `ESC [ 2 A` 这类 cursor-count 控制保持 unknown。
 - 本轮补充：keybinding config 的 page/navigation/editing key name 现在接受 `pgup`/`pg-up`/`prior`/`pageUpKey`、`pgdn`/`pg-down`/`next`/`pageDownKey`、`homeKey`/`endKey`、`deleteForward`/`forwardDelete` 和 `deleteBackward`，覆盖常见终端、DOM 和配置别名。
 - 本轮补充：keybinding config 和脚本 named-key 输入现在接受 DOM/fixture 风格的 `enterKey`/`returnKey`/`numpadEnter`、`escapeKey`/`escKey`、`tabKey`、`shiftEnterKey`/`shiftNumpadEnter`、`shiftTabKey`/`backtabKey`，减少配置导入时对基础控制键名称的手工归一。

docs/first-second-parity-audit.md

@@ -514,6 +514,7 @@ M7 progress now includes:
 - `internal/tui`: key parsing and configurable keybindings now expose `ctrl+space` from raw NUL and Kitty/CSI-u `0u`, `32;5u`, `64;5u`, and `50;5u` forms, with `ctrl-space`/`ctrl-@`/`ctrl-2` and compact `cSpace`/`c@`/`c2` aliases available for user keymaps and scripts.
 - `internal/tui`: key parsing and configurable keybindings now expose Ctrl-backslash, Ctrl-], Ctrl-^/Ctrl-6, and Ctrl-_/Ctrl-/ from raw terminal control bytes and Kitty/CSI-u forms, with symbol, named, and compact aliases available for user keymaps and scripts.
 - `internal/tui`: key parsing and configurable keybindings now expose F1-F12 from common SS3, modified SS3, legacy Linux-console, tilde CSI, and modified CSI function-key sequences, with `f1`, `function-key-1`, and `fn1` style aliases available for user keymaps and scripts; navigation input also accepts explicit-default `CSI 1 A/B/C/D/H/F` forms while leaving counted cursor controls such as `CSI 2A` as unknown.
+- `internal/tui`: terminal key parsing now accepts modified SS3 application-cursor navigation sequences such as `ESC O 1;2A`, `ESC O 1;5D`, and `ESC O 1;16C`, mapping shift to the plain navigation surface and alt/meta/ctrl combinations to the existing word-motion key surfaces.
 - `internal/tui`: terminal ESC parsing now recognizes charset selection sequences such as `ESC ( B`, `ESC ) 0`, `ESC * B`, `ESC / A`, and `ESC % G` as structured charset actions and consumes them in visible-text parsing instead of surfacing them as unknown terminal output.
 - `internal/tui`: terminal ESC parsing now also recognizes ISO-2022 charset shift controls such as `ESC N`, `ESC n`, `ESC o`, `ESC |`, `ESC }`, and `ESC ~` as structured charset-shift actions and consumes them in visible-text parsing instead of surfacing them as unknown terminal output.
 - `internal/contracts`/`internal/session`: image content blocks now normalize source aliases such as `mediaType`/`mimeType`/`contentType` and `base64`/`payload`, including top-level image block fields, into canonical `ImageSource` values during transcript resume.

internal/tui/input.go

@@ -103,6 +103,9 @@ func ParseKey(seq string) Key {
 	if key, ok := parseModifiedNavigationKey(seq); ok {
 		return key
 	}
+	if key, ok := parseModifiedSS3NavigationKey(seq); ok {
+		return key
+	}
 	if key, ok := parseFunctionKey(seq); ok {
 		return key
 	}
@@ -279,6 +282,27 @@ func parseModifiedNavigationKey(seq string) (Key, bool) {
 	}
 }
 
+func parseModifiedSS3NavigationKey(seq string) (Key, bool) {
+	switch {
+	case isModifiedNavigationSS3(seq, "A"):
+		return Key{Type: KeyUp}, true
+	case isModifiedNavigationSS3(seq, "B"):
+		return Key{Type: KeyDown}, true
+	case isModifiedNavigationSS3(seq, "C"):
+		modifier, _ := modifiedSS3NavigationModifier(seq, "C")
+		return Key{Type: modifiedHorizontalArrowKey(modifier, KeyRight, KeyAltRight, KeyCtrlRight)}, true
+	case isModifiedNavigationSS3(seq, "D"):
+		modifier, _ := modifiedSS3NavigationModifier(seq, "D")
+		return Key{Type: modifiedHorizontalArrowKey(modifier, KeyLeft, KeyAltLeft, KeyCtrlLeft)}, true
+	case isModifiedNavigationSS3(seq, "H"):
+		return Key{Type: KeyHome}, true
+	case isModifiedNavigationSS3(seq, "F"):
+		return Key{Type: KeyEnd}, true
+	default:
+		return Key{}, false
+	}
+}
+
 func parseFunctionKey(seq string) (Key, bool) {
 	switch seq {
 	case "\x1bOP", "\x1b[[A":
@@ -396,6 +420,11 @@ func isModifiedNavigationCSI(seq, prefix, suffix string) bool {
 	return ok
 }
 
+func isModifiedNavigationSS3(seq, suffix string) bool {
+	_, ok := modifiedSS3NavigationModifier(seq, suffix)
+	return ok
+}
+
 func modifiedNavigationModifier(seq, prefix, suffix string) (int, bool) {
 	if !strings.HasPrefix(seq, prefix) || !strings.HasSuffix(seq, suffix) {
 		return 0, false
@@ -408,6 +437,26 @@ func modifiedNavigationModifier(seq, prefix, suffix string) (int, bool) {
 	return modifier, modifier >= 2 && modifier <= 16
 }
 
+func modifiedSS3NavigationModifier(seq, suffix string) (int, bool) {
+	if !strings.HasPrefix(seq, "\x1bO") || !strings.HasSuffix(seq, suffix) {
+		return 0, false
+	}
+	params := strings.TrimSuffix(strings.TrimPrefix(seq, "\x1bO"), suffix)
+	base, modifierText, ok := strings.Cut(params, ";")
+	if !ok || modifierText == "" {
+		return 0, false
+	}
+	code, ok := firstCSIParamNumber(base)
+	if !ok || code != 1 || strings.ContainsAny(modifierText, ";:") {
+		return 0, false
+	}
+	modifier, err := strconv.Atoi(modifierText)
+	if err != nil {
+		return 0, false
+	}
+	return modifier, modifier >= 2 && modifier <= 16
+}
+
 func modifiedHorizontalArrowKey(modifier int, plain KeyType, alt KeyType, ctrl KeyType) KeyType {
 	if modifier >= 5 && modifier <= 8 || modifier >= 13 && modifier <= 16 {
 		return ctrl

internal/tui/tui_test.go

@@ -1029,6 +1029,33 @@ func TestParseModifiedNavigationKeySequences(t *testing.T) {
 			t.Fatalf("ParseKey(%q) = %#v, want %q", tc.seq, key, tc.want)
 		}
 	}
+
+	ss3Cases := []struct {
+		seq  string
+		want KeyType
+	}{
+		{seq: "\x1bO1;2A", want: KeyUp},
+		{seq: "\x1bO1;2B", want: KeyDown},
+		{seq: "\x1bO1;2C", want: KeyRight},
+		{seq: "\x1bO1;2D", want: KeyLeft},
+		{seq: "\x1bO1;3C", want: KeyAltRight},
+		{seq: "\x1bO1;4D", want: KeyAltLeft},
+		{seq: "\x1bO1;5C", want: KeyCtrlRight},
+		{seq: "\x1bO1;8D", want: KeyCtrlLeft},
+		{seq: "\x1bO1;10C", want: KeyAltRight},
+		{seq: "\x1bO1;13D", want: KeyCtrlLeft},
+		{seq: "\x1bO1;16C", want: KeyCtrlRight},
+		{seq: "\x1bO1;2H", want: KeyHome},
+		{seq: "\x1bO1;5F", want: KeyEnd},
+	}
+	for _, tc := range ss3Cases {
+		if key := ParseKey(tc.seq); key.Type != tc.want {
+			t.Fatalf("ParseKey(%q) = %#v, want %q", tc.seq, key, tc.want)
+		}
+	}
+	if key := ParseKey("\x1bO2;3A"); key.Type != KeyUnknown {
+		t.Fatalf("SS3 2;3A should not parse as navigation key: %#v", key)
+	}
 }
 
 func TestParseFunctionKeySequences(t *testing.T) {