Accept nested message parent aliases

Author: SqlRush

docs/cc-100-roadmap.md

@@ -34,6 +34,8 @@
 
 M6 补充：transcript resume 的嵌套 content block 现在接受 `toolUseId`/`toolUseID`、`isError`、`cacheControl`、`cacheReference` 字段别名，并保留 cache edit 的 `cacheReference`。
 
+M6 补充：嵌套 contract message 现在接受 `parentUUID`、`parentId`/`parentID`/`parent_id`、`parentMessageId`/`parentMessageID`/`parent_message_id` 和 parent-message UUID 别名，transcript/remote history payload 自带 parent alias 时不会丢失嵌套 parent。
+
 M6 补充：remote history GraphQL/connection 分页现在接受 `hasPrevious`/`hasPreviousPage`、`hasOlder`/`more` 继续分页标记，以及 `previousCursor`/`prevCursor`/`beforeCursor`/`olderCursor` 等 before-id cursor 别名，避免只返回第一页历史。
 
 M6 补充：remote history response parser 现在会递归解包 `data.session.events`、`data.projectSession.eventConnection`、`conversation`、`remoteHistory` 等 GraphQL/session wrapper，继续复用 `nodes`/`edges[].node` 和 `pageInfo` pagination 解析。

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

@@ -196,6 +196,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：lightweight transcript metadata loader 在 `system`/`compact_boundary` 后清空旧 `marble-origami-commit`/`marble-origami-snapshot` 状态，和 full loader/官方 sessionStorage compact-boundary 语义一致。
 - 本轮补充：transcript metadata loader 接受 `sessionID`/`session` 作为 session-scoped metadata ID 别名，并容忍 `prNumber`、`timeSavedMs`、`lastSpawnTokens` 等计数字段使用数字字符串。
 - 本轮补充：transcript message 和嵌套 contract message 接受顶层 `sessionID` 作为 session id 别名，`LoadTranscript`、`LoadTranscriptIndex` 和 indexed resume 会保留该 session id（覆盖测试：`TestLoadTranscriptAcceptsSessionIDUpperAlias`）。
+- 本轮补充：嵌套 contract message 接受 `parentUUID`、`parentId`/`parentID`/`parent_id`、`parentMessageId`/`parentMessageID`/`parent_message_id` 和 parent-message UUID 别名，transcript/remote history payload 自带 parent alias 时不会丢失嵌套 parent。
 - 本轮补充：remote history `SDKEvent` 解码接受顶层 `sessionID` 作为事件 session id 别名，materialize transcript 时会填充 record 与嵌套 message 的 session id（覆盖测试：`TestRemoteHistoryTranscriptMessagesAcceptsSessionIDUpperAlias`）。
 - 本轮补充：remote history `SDKEvent` 解码接受 `parentUUID`、`parentId`/`parentID`/`parent_id`、`parentMessageId`/`parentMessageID`/`parent_message_id` parent aliases，materialize transcript 时会保留 parent chain（覆盖测试：`TestRemoteHistoryTranscriptMessagesAcceptsParentIDAliases`）。
 - 本轮补充：memory 层补齐官方 `memoryAge`/freshness note 语义，`ReadDocumentsWithOptions` 可为超过 1 天的 memory 文档前缀 system-reminder，提示模型把 memory 当作 point-in-time observation 并核对当前代码。

docs/first-second-parity-audit.md

@@ -130,6 +130,7 @@ M6 progress now includes:
 - `internal/session`: transcript full loader and line-offset index now accept top-level record UUID aliases such as `messageUuid`, `messageUUID`, `message_id`, `messageId`, and `id`, plus parent message UUID/ID aliases for progress bridge and indexed resume paths.
 - `internal/session`: transcript full loader and line-offset index now accept entry type aliases such as `role`, `entry_type`, and `messageType`, plus `createdAt`/`created_at` timestamp aliases.
 - `internal/contracts`/`internal/session`: transcript resume now accepts nested content block aliases for `toolUseId`/`toolUseID`, `isError`, `cacheControl`, `cacheReference`, and cache edit `cacheReference`.
+- `internal/contracts`/`internal/session`: nested contract messages now accept parent aliases such as `parentUUID`, `parentId`/`parentID`/`parent_id`, `parentMessageId`/`parentMessageID`/`parent_message_id`, and parent-message UUID aliases, preserving payload-supplied parents in transcript and remote-history resume paths.
 - `internal/session`: remote-history parsing now also accepts connection-style `history`/`messages` wrappers with `nodes`/`edges[].node` event lists and `pageInfo`/`page_info` `hasNextPage`/`endCursor`/`startCursor` pagination aliases.
 - `internal/session`: remote-history connection edges now use `edges[].cursor` as the event cursor when the nested node lacks an event ID, preserving pagination even when pageInfo omits a cursor.
 - `internal/session`: remote-history parsing now also accepts `eventList`/`event_list`, `sessionEvents`/`session_events`, and connection aliases such as `connection`, `eventConnection`, and `sessionEventsConnection`.

internal/contracts/messages.go

@@ -164,13 +164,23 @@ func (m *Message) UnmarshalJSON(data []byte) error {
 	type MessageJSON Message
 	var aux struct {
 		*MessageJSON
-		ParentUUIDSnake  *ID   `json:"parent_uuid"`
-		SessionIDUpper   ID    `json:"sessionID"`
-		SessionIDSnake   ID    `json:"session_id"`
-		SessionUUID      ID    `json:"sessionUuid"`
-		SessionUUIDUpper ID    `json:"sessionUUID"`
-		SessionUUIDSnake ID    `json:"session_uuid"`
-		IsMetaSnake      *bool `json:"is_meta"`
+		ParentUUIDUpper        *ID   `json:"parentUUID"`
+		ParentUUIDSnake        *ID   `json:"parent_uuid"`
+		ParentID               *ID   `json:"parentId"`
+		ParentIDUpper          *ID   `json:"parentID"`
+		ParentIDSnake          *ID   `json:"parent_id"`
+		ParentMessageID        *ID   `json:"parentMessageId"`
+		ParentMessageIDUpper   *ID   `json:"parentMessageID"`
+		ParentMessageIDSnake   *ID   `json:"parent_message_id"`
+		ParentMessageUUID      *ID   `json:"parentMessageUuid"`
+		ParentMessageUUIDUpper *ID   `json:"parentMessageUUID"`
+		ParentMessageUUIDSnake *ID   `json:"parent_message_uuid"`
+		SessionIDUpper         ID    `json:"sessionID"`
+		SessionIDSnake         ID    `json:"session_id"`
+		SessionUUID            ID    `json:"sessionUuid"`
+		SessionUUIDUpper       ID    `json:"sessionUUID"`
+		SessionUUIDSnake       ID    `json:"session_uuid"`
+		IsMetaSnake            *bool `json:"is_meta"`
 	}
 	base := MessageJSON{}
 	aux.MessageJSON = &base
@@ -179,7 +189,19 @@ func (m *Message) UnmarshalJSON(data []byte) error {
 	}
 	*m = Message(base)
 	if m.ParentUUID == nil {
-		m.ParentUUID = aux.ParentUUIDSnake
+		m.ParentUUID = firstMessageIDPtr(
+			aux.ParentUUIDUpper,
+			aux.ParentUUIDSnake,
+			aux.ParentID,
+			aux.ParentIDUpper,
+			aux.ParentIDSnake,
+			aux.ParentMessageID,
+			aux.ParentMessageIDUpper,
+			aux.ParentMessageIDSnake,
+			aux.ParentMessageUUID,
+			aux.ParentMessageUUIDUpper,
+			aux.ParentMessageUUIDSnake,
+		)
 	}
 	if m.SessionID == "" {
 		m.SessionID = aux.SessionIDUpper
@@ -202,6 +224,16 @@ func (m *Message) UnmarshalJSON(data []byte) error {
 	return nil
 }
 
+func firstMessageIDPtr(values ...*ID) *ID {
+	for _, value := range values {
+		if value != nil && *value != "" {
+			cloned := *value
+			return &cloned
+		}
+	}
+	return nil
+}
+
 type APIMessage struct {
 	Role    string         `json:"role"`
 	Content []ContentBlock `json:"content"`

internal/session/transcript_test.go

@@ -35,7 +35,7 @@ func TestLoadTranscriptAcceptsMessageFieldAliases(t *testing.T) {
 	path := writeTranscript(t, []string{
 		`{"type":"user","uuid":"u1","session_id":"sess_1","timestamp":"2026-01-01T00:00:00Z","message":{"type":"user","session_id":"sess_1","content":[{"type":"text","text":"hi"}]}}`,
 		`{"type":"progress","uuid":"p1","parent_uuid":"u1"}`,
-		`{"type":"assistant","uuid":"a1","parent_uuid":"p1","logical_parent_uuid":"u1","session_id":"sess_1","is_sidechain":true,"agent_id":"agent_alias","timestamp":"2026-01-01T00:00:01Z","message":{"id":"msg_1","type":"assistant","parent_uuid":"u1","session_id":"sess_1","is_meta":true,"content":[{"type":"text","text":"done"}]}}`,
+		`{"type":"assistant","uuid":"a1","parent_uuid":"p1","logical_parent_uuid":"u1","session_id":"sess_1","is_sidechain":true,"agent_id":"agent_alias","timestamp":"2026-01-01T00:00:01Z","message":{"id":"msg_1","type":"assistant","parentMessageID":"u1","session_id":"sess_1","is_meta":true,"content":[{"type":"text","text":"done"}]}}`,
 	})
 
 	transcript, err := LoadTranscript(path)