Wire clear result into REPL screen

Author: SqlRush

docs/cc-100-roadmap.md

@@ -245,9 +245,9 @@ M8 补充：project legacy `.claude/commands/**/*.md` 和 user legacy `${CLAUDE_
 
 M8 补充：现有 Go 内置 slash command metadata 继续贴近官方源快照，补齐 `config`/`resume`/`clear` 的 aliases（`settings`、`continue`、`reset`、`new`），以及 `mcp`/`resume`/`model` 的 argument hint、`mcp`/`status`/`model` 的 immediate 标记和部分官方描述；大量内置 command 的真实 local/local-jsx UI 执行仍未完成。
 
-M8 补充：slash command 现在有基础 local command result 抽象，`/clear` 不再落入 unsupported 分支，会生成 local text result、保留 command metadata message，并且不会请求模型；完整 REPL conversation reset、local command text/compact/skip 全语义、`/cost`/`/status`/`/compact` 和 local-jsx UI 执行仍未完成。
+M8 补充：slash command 现在有基础 local command result 抽象，`/clear` 不再落入 unsupported 分支，会生成 local text result、保留 command metadata message，并且不会请求模型；REPL screen 已提供 clear-result 消费路径，可清空 transcript viewport/selection/reverse-search 并按当前 draft 重算 paste/image 引用编号；完整 local command text/compact/skip 全语义、`/cost`/`/status`/`/compact` 和 local-jsx UI 执行仍未完成。
 
-M8/M7 补充：`/clear` local command 现在返回专用 clear result，并在 conversation `Result.Cleared` 中暴露结构化清空信号；runner 仍保留 command metadata transcript 且不请求模型，完整 TUI/REPL 历史重置接线仍需由交互主循环消费该信号完成。
+M8/M7 补充：`/clear` local command 现在返回专用 clear result，并在 conversation `Result.Cleared` 中暴露结构化清空信号；`REPLScreen.ClearConversation` 和交互脚本 `conversationCleared` alias 可消费该信号，清空屏幕会话历史但保留 prompt 输入历史，runner 仍保留 command metadata transcript 且不请求模型。
 
 M8/CLI 补充：`--print --output-format json|stream-json` 现在会为 `/clear` 这类空文本本地结果输出 final result envelope，并用 `cleared: true` 暴露清空信号；普通空文本结果仍保持不输出，完整 SDK/control protocol clear event parity 仍需后续补齐。
 

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

@@ -312,7 +312,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：skill frontmatter 标量兼容继续补齐，`allowed_tools`/`argument_hint`/`disable_model_invocation`/`user_invocable`/`when-to-use` 等相邻字段会映射到 canonical command metadata；`model: inherit` 不再误触发模型覆盖，`context: fork`、`agent`、`effort` 会保留在 command contract 中，为后续 forked skill/agent 执行接线提供 metadata；当 policy 锁定 `agents` surface 时，非可信来源 prompt command 的这些 agent metadata 会在 registry 层清除，plugin/bundled/admin 来源保留。
 - 本轮补充：project legacy `.claude/commands/**/*.md` 现在会加载为 `commands_DEPRECATED` prompt command，覆盖普通 markdown 命名空间、目录式 `SKILL.md` 命名空间、frontmatter metadata、SkillTool 可见性过滤和 prompt expansion；目录式 legacy command 保留 base directory 前缀和 `${CLAUDE_SKILL_DIR}` 替换。完整 user/managed commands、plugin commands、local/local-jsx 执行仍未宣称完成。
 - 本轮补充：现有 Go 内置 slash command metadata 继续贴近官方源快照，补齐 `config`/`resume`/`clear` 的 aliases（`settings`、`continue`、`reset`、`new`），以及 `mcp`/`resume`/`model` 的 argument hint、`mcp`/`status`/`model` 的 immediate 标记和部分官方描述；大量内置 command 的真实 local/local-jsx UI 执行仍未宣称完成。
-- 本轮补充：slash command 现在有基础 local command result 抽象，`/clear` 不再落入 unsupported 分支，会生成 local text result、保留 command metadata message，并且不会请求模型；完整 REPL conversation reset、local command text/compact/skip 全语义、`/cost`/`/status`/`/compact` 和 local-jsx UI 执行仍未宣称完成。
+- 本轮补充：slash command 现在有基础 local command result 抽象，`/clear` 不再落入 unsupported 分支，会生成 local text result、保留 command metadata message，并且不会请求模型；REPL screen 已提供 clear-result 消费路径，可清空 transcript viewport/selection/reverse-search 并按当前 draft 重算 paste/image 引用编号；完整 local command text/compact/skip 全语义、`/cost`/`/status`/`/compact` 和 local-jsx UI 执行仍未宣称完成。
 - 本轮补充：`/cost status`、`/cost current` 和 `/cost usage` 现在复用 `/cost` totals no-query 本地路径，未知 cost 子命令仍保持显式未实现提示，`/cost breakdown`/`show` 继续输出逐消息明细。
 - 本轮补充：`/memory files` 和 `/memory ls` 现在复用 `/memory list` 的 no-query 本地记忆文件列表路径，`/memory status` 仍保持会话/相关记忆概览。
 - 本轮补充：`/status <section>` 现在复用 `/status show <section>` 的 section alias normalization，`/status integrations`、`/status diagnostics` 等直接调用不会再落入 unsupported subcommand 分支。

docs/first-second-parity-audit.md

@@ -76,7 +76,7 @@ Anthropic API 和 conversation：
 - `internal/commands` now has a metadata registry that merges command sources in the official order, loads project skill commands from the working directory, deduplicates dynamic skills, resolves commands by canonical name/display name/alias, filters visible commands, exposes SkillTool/slash-skill command subsets, and applies the bridge-safe predicate for prompt/local/local-jsx commands.
 - Built-in slash command metadata now preserves official aliases for the currently declared Go builtins such as `settings`, `continue`, `reset`, and `new`, plus argument hints and immediate markers for `mcp`, `resume`, `status`, and `model`.
 - The command registry now retains local skill prompt templates and can expand prompt commands into meta user messages, including `$ARGUMENTS`, indexed/shorthand arguments, frontmatter named arguments, `${CLAUDE_SESSION_ID}` substitution, and non-MCP `${CLAUDE_SKILL_DIR}` substitution.
-- Slash command execution now has a basic local command result abstraction, and `/clear` follows a no-query local text-result path instead of returning the generic unsupported local-command stderr; full local command result handling and REPL state reset remain incomplete.
+- Slash command execution now has a basic local command result abstraction, `/clear` follows a no-query local text-result path, and the REPL screen can consume the cleared result by resetting transcript viewport/selection/reverse-search while preserving prompt input history; broader local command result handling remains incomplete.
 - `/status <section>` now shares the same section-alias normalization as `/status show <section>`, so direct invocations such as `/status integrations` and `/status diagnostics` take the no-query local status path instead of falling into the unsupported-subcommand branch.
 - `/cost status`, `/cost current`, and `/cost usage` now share the no-query totals path with `/cost`, while `/cost breakdown`/`show` continue to return per-message usage details and unknown subcommands remain explicit.
 - `/summary`, `/release-notes`, and `/files` are now registered as bridge-safe built-in local commands and take no-query local result paths: `/summary` reports deterministic session/history counts and previews, `/release-notes` reports the bundled release-notes availability state, and `/files` lists first-level workspace entries without reading file contents.

internal/tui/input.go

@@ -943,6 +943,28 @@ func (p *PromptState) SeedNextPastedIDFromMessages(messages []Message) {
 	p.NextPastedID = next
 }
 
+func (p *PromptState) resetPastedIDFromDraft() {
+	if !p.UsePasteReferences {
+		return
+	}
+	next := 1
+	for id, content := range p.PastedContents {
+		contentID := id
+		if content.ID > 0 {
+			contentID = content.ID
+		}
+		if contentID >= next {
+			next = contentID + 1
+		}
+	}
+	for _, ref := range session.ParseReferences(p.Text) {
+		if ref.ID >= next {
+			next = ref.ID + 1
+		}
+	}
+	p.NextPastedID = next
+}
+
 func (p *PromptState) SetPasteReferenceRows(rows int) {
 	p.MaxInlinePasteLines = maxInlinePasteLines(rows)
 }

internal/tui/screen.go

@@ -145,6 +145,15 @@ func (s *REPLScreen) AppendMessage(message Message) {
 	s.Viewport.ScrollToBottom()
 }
 
+func (s *REPLScreen) ClearConversation() {
+	s.Messages = nil
+	s.SelectedViewportLine = -1
+	s.ReverseSearch = ReverseSearchState{}
+	s.Prompt.resetPastedIDFromDraft()
+	s.rebuildViewport()
+	s.Viewport.ScrollToTop()
+}
+
 func (s *REPLScreen) ApplyKey(key Key) ScreenEvent {
 	switch key.Type {
 	case KeyFocusIn:

internal/tui/script.go

@@ -28,6 +28,7 @@ type ScriptStep struct {
 	CancelAllTasks               bool
 	CancelTasksDetail            string
 	OpenTasksDialog              bool
+	ClearConversation            bool
 	ResizeWidth                  int
 	ResizeHeight                 int
 	SnapshotName                 string
@@ -223,6 +224,9 @@ func runInteractionScriptChecked(screen *REPLScreen, steps []ScriptStep, runtime
 			}
 			screen.Keymap = keymap
 		}
+		if step.ClearConversation {
+			screen.ClearConversation()
+		}
 		if step.ResizeWidth > 0 {
 			width := step.ResizeWidth
 			height := screen.Height

internal/tui/script_aliases.go

@@ -712,6 +712,12 @@ func (step *ScriptStep) UnmarshalJSON(data []byte) error {
 		OpenTasksCamel            *json.RawMessage `json:"openTasks"`
 		ShowTasks                 *json.RawMessage `json:"show_tasks"`
 		ShowTasksCamel            *json.RawMessage `json:"showTasks"`
+		ClearConversation         *json.RawMessage `json:"clear_conversation"`
+		ClearConversationCamel    *json.RawMessage `json:"clearConversation"`
+		ConversationCleared       *json.RawMessage `json:"conversation_cleared"`
+		ConversationClearedCamel  *json.RawMessage `json:"conversationCleared"`
+		ApplyClearResult          *json.RawMessage `json:"apply_clear_result"`
+		ApplyClearResultCamel     *json.RawMessage `json:"applyClearResult"`
 		ResizeWidth               *json.RawMessage `json:"resize_width"`
 		ResizeWidthCamel          *json.RawMessage `json:"resizeWidth"`
 		ResizeHeight              *json.RawMessage `json:"resize_height"`
@@ -1009,6 +1015,9 @@ func (step *ScriptStep) UnmarshalJSON(data []byte) error {
 	if value, ok := scriptRuntimeMutationBoolField(fieldMap, "OpenTasksDialog", "open_tasks_dialog", "openTasksDialog", "OpenTasks", "open_tasks", "openTasks", "ShowTasks", "show_tasks", "showTasks"); ok {
 		step.OpenTasksDialog = value
 	}
+	if value, ok := scriptRuntimeMutationBoolField(fieldMap, "ClearConversation", "clear_conversation", "clearConversation", "ConversationCleared", "conversation_cleared", "conversationCleared", "ApplyClearResult", "apply_clear_result", "applyClearResult"); ok {
+		step.ClearConversation = value
+	}
 	if step.ResizeWidth <= 0 {
 		if width, ok := scriptNamedIntField(rawFieldMap,
 			[]string{"ResizeWidth", "resize_width", "resizeWidth"},
@@ -1782,6 +1791,12 @@ func scriptStepJSONHasDirectFields(fields map[string]json.RawMessage) bool {
 		"task_status",
 		"taskStatus",
 		"dialog",
+		"clear_conversation",
+		"clearConversation",
+		"conversation_cleared",
+		"conversationCleared",
+		"apply_clear_result",
+		"applyClearResult",
 		"expect_event",
 		"expectEvent",
 		"expect_events",
@@ -1902,6 +1917,8 @@ func applyScriptStepActionAlias(step *ScriptStep, fields map[string]json.RawMess
 		}
 	case "opentasks", "open-tasks", "opentasksdialog", "open-tasks-dialog", "showtasks", "show-tasks":
 		step.OpenTasksDialog = scriptActionBoolField(fields, true)
+	case "clearconversation", "clear-conversation", "conversationcleared", "conversation-cleared", "applyclearresult", "apply-clear-result", "clearresult", "clear-result":
+		step.ClearConversation = scriptActionBoolField(fields, true)
 	case "cancelactivedialog", "cancel-active-dialog", "canceldialog", "cancel-dialog", "closedialog", "close-dialog":
 		step.CancelActiveDialog = scriptActionBoolField(fields, true)
 	case "cancelpermission", "cancel-permission":

internal/tui/tui_test.go

@@ -595,6 +595,38 @@ func TestREPLScreenSeedsNextPastedIDFromMessages(t *testing.T) {
 	}
 }
 
+func TestREPLScreenClearConversationResetsTranscriptState(t *testing.T) {
+	screen := NewREPLScreen(40, 6, []string{"previous prompt"})
+	screen.SetMessages([]Message{
+		{Role: RoleUser, Text: "old [Image #9]"},
+		{Role: RoleAssistant, Text: "old answer"},
+		{Role: RoleUser, Text: "older [Pasted text #12]"},
+	})
+	screen.SelectedViewportLine = 1
+	screen.OpenReverseSearch("previous")
+	screen.Prompt.Text = "draft [Image #4]"
+	screen.Prompt.PastedContents = map[int]session.PastedContent{
+		4: {ID: 4, Type: session.PastedContentImage, Filename: "draft.png"},
+	}
+	screen.Prompt.NextPastedID = 13
+
+	screen.ClearConversation()
+
+	if len(screen.Messages) != 0 || len(screen.Viewport.Lines) != 0 || screen.Viewport.Offset != 0 {
+		t.Fatalf("screen transcript not cleared: messages=%#v viewport=%#v", screen.Messages, screen.Viewport)
+	}
+	if screen.SelectedViewportLine != -1 || screen.ReverseSearch.Active {
+		t.Fatalf("selection/search state = line %d reverse=%#v", screen.SelectedViewportLine, screen.ReverseSearch)
+	}
+	if screen.Prompt.Text != "draft [Image #4]" || screen.Prompt.NextPastedID != 5 || screen.Prompt.historyLength() != 1 {
+		t.Fatalf("prompt after clear = %#v", screen.Prompt)
+	}
+	screen.ApplyKey(ParseKey("\x1b]1337;File=name=next.png;type=image/png;inline=1:BBBB\a"))
+	if !strings.Contains(screen.Prompt.Text, "[Image #5]") || screen.Prompt.NextPastedID != 6 {
+		t.Fatalf("prompt pasted id after clear = %#v", screen.Prompt)
+	}
+}
+
 func TestPromptImageHintWritesImageCacheWhenEnabled(t *testing.T) {
 	dir := t.TempDir()
 	t.Setenv("CLAUDE_CONFIG_DIR", dir)
@@ -11199,6 +11231,32 @@ func TestRunInteractionScriptChecksEventSequences(t *testing.T) {
 	}
 }
 
+func TestRunInteractionScriptAppliesConversationClearedAlias(t *testing.T) {
+	steps, err := ParseInteractionScript([]byte(`[
+		{"message": {"role": "user", "text": "old question"}},
+		{"message": {"role": "assistant", "text": "old answer"}},
+		{
+			"conversationCleared": true,
+			"expectSnapshotNotContains": ["old question", "old answer"],
+			"expectViewport": {"visibleNotContains": ["old question", "old answer"]},
+			"expectNoEvent": true
+		}
+	]`))
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !steps[2].ClearConversation {
+		t.Fatalf("clear alias not parsed: %#v", steps[2])
+	}
+	screen := NewREPLScreen(40, 8, nil)
+	if _, err := RunInteractionScriptChecked(&screen, steps); err != nil {
+		t.Fatal(err)
+	}
+	if len(screen.Messages) != 0 || len(screen.Viewport.Lines) != 0 {
+		t.Fatalf("screen not cleared: messages=%#v viewport=%#v", screen.Messages, screen.Viewport)
+	}
+}
+
 func TestRunInteractionScriptChecksJSONEventCounts(t *testing.T) {
 	steps, err := ParseInteractionScript([]byte(`[
 		{