Parse SS3 cursor sequences

Author: SqlRush

docs/cc-100-roadmap.md

@@ -136,6 +136,8 @@ M7 补充：terminal CSI parser 现在把 TBC tab-clear (`CSI g`/`CSI 3g`) 解
 
 M7 补充：terminal ESC parser 现在把 HTS horizontal-tab-set (`ESC H`) 解析成 cursor/tab-set action，和 CSI tab-clear 控制序列形成闭环。
 
+M7 补充：terminal sequence dispatcher 现在把 SS3 application cursor (`ESC OA`/`OB`/`OC`/`OD`) 解析成结构化 cursor move action，避免 application cursor mode 序列落入 unknown。
+
 M7 补充：terminal CSI parser 现在把 REP repeat-preceding-character (`CSI b`/`CSI 4b`) 解析成 edit action，visible-text/snapshot pipeline 和 ANSI message wrapping/trim 会按重复次数展开前一个可重复 grapheme。
 
 M7 补充：terminal CSI parser 现在按 ANSI 默认参数解析 scroll-region (`CSI r`/`CSI ;10r`)，缺失 top 默认为 1，缺失 bottom 保持为 0 表示 reset/full-height，避免把 reset 误判为单行区域。

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

@@ -248,6 +248,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：terminal CSI parser 把 xterm window manipulation/report (`CSI t`) 归入 report action，覆盖常见 `CSI 14t`/`CSI 18t` 窗口/文本区尺寸查询。
 - 本轮补充：terminal CSI parser 把 TBC tab-clear (`CSI g`/`CSI 3g`) 归入 cursor action，保留 clear-current/all code。
 - 本轮补充：terminal ESC parser 把 HTS horizontal-tab-set (`ESC H`) 归入 cursor/tab-set action，和 CSI tab-clear 控制序列形成闭环。
+- 本轮补充：terminal sequence dispatcher 把 SS3 application cursor (`ESC OA`/`OB`/`OC`/`OD`) 归入结构化 cursor move action，避免 application cursor mode 序列落入 unknown。
 - 本轮补充：terminal CSI parser 把 REP repeat-preceding-character (`CSI b`) 归入 edit action，visible-text/snapshot pipeline 和 ANSI message wrapping/trim 会按重复次数展开前一个可重复 grapheme。
 - 本轮补充：terminal CSI parser 按 ANSI 默认参数解析 scroll-region (`CSI r`/`CSI ;10r`)，缺失 top 默认为 1，缺失 bottom 保持 0 表示 reset/full-height，避免 reset scroll region 被误判为单行区域。
 - 本轮补充：terminal CSI parser 把 DECSTR soft reset (`CSI !p`) 归入 reset action，并在 terminal parser 中清理 SGR/link 状态。

docs/first-second-parity-audit.md

@@ -213,6 +213,7 @@ M7 progress now includes:
 - `internal/tui`: terminal CSI parsing now emits cursor actions for TBC tab-clear sequences such as `CSI g` and `CSI 3g`, preserving the clear-current/all code.
 - `internal/tui`: terminal CSI parsing now emits edit actions for REP repeat-preceding-character sequences such as `CSI b` and `CSI 4b`, and the visible-text/snapshot plus ANSI message wrapping/trim paths expand the previous repeatable grapheme by the requested count.
 - `internal/tui`: terminal CSI parsing now emits reset actions for DECSTR soft reset `CSI !p`, and the terminal parser clears SGR/link state through the existing reset path.
+- `internal/tui`: terminal sequence dispatch now parses SS3 application cursor sequences such as `ESC OA`/`OB`/`OC`/`OD` as structured cursor move actions.
 - `internal/tui`: image hint parsing now accepts OSC ST terminators and base64 `name=` filenames while preserving prompt pasted-content metadata.
 - `internal/session`: prompt history writing now skips image pasted-content records like official `history.ts`, while the reader still accepts older image metadata entries.
 - `internal/session`: paste-cache now has a best-effort cutoff-mtime cleanup helper for old `.txt` paste files, matching official `cleanupOldPastes` behavior.

internal/tui/terminal_parser.go

@@ -224,7 +224,7 @@ func (p *TerminalParser) processSequence(sequence string) (TerminalAction, bool)
 		return TerminalAction{}, false
 	}
 	switch action.Type {
-	case TerminalSequenceCSI:
+	case TerminalSequenceCSI, TerminalSequenceSS3:
 		switch action.CSI.Type {
 		case CSIActionSGR:
 			p.style = ApplySGR(action.CSI.SGRParams, p.style)

internal/tui/terminal_parser_test.go

@@ -194,8 +194,8 @@ func TestTerminalParserDispatchesSequenceActions(t *testing.T) {
 	if actions[8].Type != TerminalActionCursor || actions[8].Cursor.Type != CSICursorActionMove || actions[8].Cursor.Direction != CSICursorDown {
 		t.Fatalf("esc cursor action = %#v", actions[8])
 	}
-	if actions[9].Type != TerminalActionUnknown || actions[9].Sequence != "\x1bOA" {
-		t.Fatalf("unknown action = %#v", actions[9])
+	if actions[9].Type != TerminalActionCursor || actions[9].Cursor.Type != CSICursorActionMove || actions[9].Cursor.Direction != CSICursorUp || actions[9].Cursor.Count != 1 {
+		t.Fatalf("ss3 cursor action = %#v", actions[9])
 	}
 }
 

internal/tui/terminal_sequence.go

@@ -81,7 +81,11 @@ func ParseTerminalSequence(sequence string) (TerminalSequenceAction, bool) {
 		}
 		return TerminalSequenceAction{Type: TerminalSequenceESC, ESC: action}, true
 	case TerminalSequenceSS3:
-		return TerminalSequenceAction{Type: TerminalSequenceUnknown, Sequence: sequence}, true
+		action, ok := ParseSS3Sequence(sequence)
+		if !ok {
+			return TerminalSequenceAction{Type: TerminalSequenceUnknown, Sequence: sequence}, true
+		}
+		return TerminalSequenceAction{Type: TerminalSequenceSS3, CSI: action}, true
 	case TerminalSequenceDCS, TerminalSequenceAPC, TerminalSequencePM, TerminalSequenceSOS:
 		return TerminalSequenceAction{
 			Type:          IdentifyTerminalSequence(sequence),
@@ -95,6 +99,24 @@ func ParseTerminalSequence(sequence string) (TerminalSequenceAction, bool) {
 	}
 }
 
+func ParseSS3Sequence(sequence string) (CSIAction, bool) {
+	if !strings.HasPrefix(sequence, ESCPrefix+"O") || len(sequence) != 3 {
+		return CSIAction{}, false
+	}
+	switch sequence[2] {
+	case 'A':
+		return csiCursorMove(CSICursorUp, 1), true
+	case 'B':
+		return csiCursorMove(CSICursorDown, 1), true
+	case 'C':
+		return csiCursorMove(CSICursorForward, 1), true
+	case 'D':
+		return csiCursorMove(CSICursorBack, 1), true
+	default:
+		return CSIAction{}, false
+	}
+}
+
 func ParseTerminalStringControl(sequence string) TerminalStringControlAction {
 	control := TerminalStringControlAction{
 		Type:     IdentifyTerminalSequence(sequence),

internal/tui/terminal_sequence_test.go

@@ -45,9 +45,13 @@ func TestParseTerminalSequenceDispatchesActions(t *testing.T) {
 	}
 
 	ss3, ok := ParseTerminalSequence("\x1bOA")
-	if !ok || ss3.Type != TerminalSequenceUnknown || ss3.Sequence != "\x1bOA" {
+	if !ok || ss3.Type != TerminalSequenceSS3 || ss3.CSI.Type != CSIActionCursor || ss3.CSI.Cursor.Type != CSICursorActionMove || ss3.CSI.Cursor.Direction != CSICursorUp || ss3.CSI.Cursor.Count != 1 {
 		t.Fatalf("ss3 dispatch = %#v ok=%v", ss3, ok)
 	}
+	unknownSS3, ok := ParseTerminalSequence("\x1bOP")
+	if !ok || unknownSS3.Type != TerminalSequenceUnknown || unknownSS3.Sequence != "\x1bOP" {
+		t.Fatalf("unknown ss3 dispatch = %#v ok=%v", unknownSS3, ok)
+	}
 
 	dcs, ok := ParseTerminalSequence("\x1bPtmux;" + EnterAlternateScreen + OSCStringTerminator)
 	if !ok || dcs.Type != TerminalSequenceDCS || dcs.StringControl.Type != TerminalSequenceDCS || !dcs.StringControl.Complete || dcs.StringControl.Terminator != OSCStringTerminator || dcs.StringControl.Payload != "tmux;"+EnterAlternateScreen {