Accept sidechain timestamp aliases

Author: SqlRush

docs/cc-100-roadmap.md

@@ -152,6 +152,8 @@ M6 补充：sidechain/subagent lifecycle 的 ID 等 string-like 字段现在接
 
 M6 补充：sidechain runtime finish 现在会在写入 summary 前把 `success`/`error`/`canceled` 等状态别名归一为 `completed`/`failed`/`cancelled`，让 sidechain transcript 与主 transcript 的 lifecycle 输出保持 canonical。
 
+M6 补充：sidechain lifecycle start/end time 现在接受 `startTimestamp`/`startTimestampMs`/`startedAtUnix` 以及 `endTimestamp`/`completedTimestamp`/`completedAtUnixMs` 等相邻时间别名，恢复第三方/旧 runtime transcript 时不再只依赖 `startedAt`/`endedAt`。
+
 M6 补充：sidechain agent metadata sidecar 读取现在接受 `type`/`subagentType`/`agentName`/`name`、`workspacePath`/`workspace`/`path`/`directory`、`taskDescription`/`prompt`/`input`/`command`/`title` 等字段别名，兼容历史或第三方生成的 subagent metadata。
 
 M6 补充：transcript metadata loader 现在会按 `messageId` 建立 file-history snapshot 和 attribution snapshot 索引，并接受 `message_id`/`messageUuid`/`id` 等字段别名，和官方按消息恢复 snapshot 的语义对齐。

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

@@ -220,6 +220,7 @@ test/parity/                 # golden tests against TS/official behavior
 - 本轮补充：remote history pagination 现在接受 `starting_after`/`startingAfter`/`after*` cursor aliases，page 字段和 link URL query 都可驱动下一页 `before_id` 续抓。
 - 本轮补充：remote history `SDKEvent` 本体接受 `eventType`/`event_type`/`role` 类型别名、`createdAt`/`created_at` 时间戳别名，以及 `payload`/`data`/`body`/`metadata`/`meta`/`attributes`/`properties`/`serializedMessage` message payload 别名；payload 只有 `role`/`content` 时也能 materialize 成 transcript message。
 - 本轮补充：sidechain lifecycle 读取现在接受运行时相邻字段别名，包括 `jobId`/`threadId`/`workflowId`/`operationId`/`requestId`、`workerType`/`taskType`、`workspaceRoot`/`projectPath`、`instructions`/`operationName`/`commandName`/`displayTitle`、`jobStatus`、`resultState`、`outputText` 和毫秒级 start/end time 字段，并会递归解包 `runtime`/`context`/`state` 容器。
+- 本轮补充：sidechain lifecycle start/end time 现在接受 `startTimestamp`/`startTimestampMs`/`startedAtUnix` 以及 `endTimestamp`/`completedTimestamp`/`completedAtUnixMs` 等相邻时间别名，恢复第三方/旧 runtime transcript 时不再只依赖 `startedAt`/`endedAt`。
 - 本轮补充：sidechain lifecycle 和 metadata sidecar 的 task description/summary 读取现在接受 visible text payload，包括 text content block、message object、content block array、provider-style `message.content`/`parts`/`outputText` wrapper，并继续跳过 thinking/tool/image 等非可见块。
 - 本轮补充：transcript resume 的嵌套 content block 接受 `toolUseId`/`toolUseID`、`isError`、`cacheControl`、`cacheReference` 字段别名，并保留 cache edit 的 `cacheReference`。
 - 本轮补充：transcript resume 的 nested content block `id`/`tool_use_id`/`toolUseId` 现在接受 JSON number，并保留为字符串 tool-use ID。

docs/first-second-parity-audit.md

@@ -219,6 +219,7 @@ M6 progress now includes:
 - `internal/session`: sidechain lifecycle field extraction now also traverses collection wrappers such as `edges`, `nodes`, and `included`, plus array elements, so GraphQL connection or JSON:API included start/summary payloads can still recover state/list/resume fields.
 - `internal/session`: sidechain lifecycle scalar fields now accept JSON number values for IDs and other string-like fields, preserving numeric subagent IDs as strings across state/list/resume recovery.
 - `internal/session`: sidechain lifecycle and metadata sidecar loading now accept adjacent runtime aliases such as `jobId`, `threadId`, `workflowId`, `operationId`, `requestId`, `workerType`, `taskType`, `workspaceRoot`, `projectPath`, `instructions`, `operationName`, `commandName`, `displayTitle`, `jobStatus`, `resultState`, `outputText`, and millisecond start/end time fields under `runtime`/`context`/`state` or JSON:API/resource wrappers.
+- `internal/session`: sidechain lifecycle start/end time loading now also accepts timestamp and Unix-style aliases such as `startTimestamp`, `startTimestampMs`, `startedAtUnix`, `endTimestamp`, `completedTimestamp`, and `completedAtUnixMs`, preserving lifecycle times from adjacent runtime transcript writers.
 - `internal/session`: sidechain lifecycle and metadata sidecar summary/description loading now accepts visible text payloads, including text content blocks, message objects, content block arrays, and provider-style `message.content`/`parts`/`outputText` wrappers while ignoring hidden thinking/tool/image blocks.
 - `internal/session`: sidechain runtime finish now canonicalizes status aliases such as `success`, `error`, and `canceled` before writing summary records, keeping sidechain and main transcript lifecycle output stable.
 - `internal/session`: sidechain runtime now rejects duplicate starts while the same sidechain ID is running, and state loading treats a later start as a fresh lifecycle by clearing stale summary/end metadata.

internal/session/sidechain_status.go

@@ -91,10 +91,19 @@ var sidechainLifecycleStartTimeFields = []string{
 	"startedAt", "started_at",
 	"startTime", "start_time",
 	"startedTime", "started_time",
+	"startTimestamp", "start_timestamp",
+	"startedTimestamp", "started_timestamp",
 	"createdAt", "created_at",
 	"startedAtMs", "started_at_ms",
 	"startTimeMs", "start_time_ms",
+	"startTimestampMs", "start_timestamp_ms",
 	"createdAtMs", "created_at_ms",
+	"startedAtUnix", "started_at_unix",
+	"startTimeUnix", "start_time_unix",
+	"startTimestampUnix", "start_timestamp_unix",
+	"startedAtUnixMs", "started_at_unix_ms",
+	"startTimeUnixMs", "start_time_unix_ms",
+	"startTimestampUnixMs", "start_timestamp_unix_ms",
 	"timestamp", "time",
 }
 
@@ -104,11 +113,25 @@ var sidechainLifecycleEndTimeFields = []string{
 	"completedAt", "completed_at",
 	"finishedAt", "finished_at",
 	"stoppedAt", "stopped_at",
+	"endTimestamp", "end_timestamp",
+	"completedTimestamp", "completed_timestamp",
+	"finishedTimestamp", "finished_timestamp",
 	"endedAtMs", "ended_at_ms",
 	"endTimeMs", "end_time_ms",
 	"completedAtMs", "completed_at_ms",
 	"finishedAtMs", "finished_at_ms",
 	"stoppedAtMs", "stopped_at_ms",
+	"endTimestampMs", "end_timestamp_ms",
+	"completedTimestampMs", "completed_timestamp_ms",
+	"finishedTimestampMs", "finished_timestamp_ms",
+	"endedAtUnix", "ended_at_unix",
+	"endTimeUnix", "end_time_unix",
+	"completedAtUnix", "completed_at_unix",
+	"finishedAtUnix", "finished_at_unix",
+	"endedAtUnixMs", "ended_at_unix_ms",
+	"endTimeUnixMs", "end_time_unix_ms",
+	"completedAtUnixMs", "completed_at_unix_ms",
+	"finishedAtUnixMs", "finished_at_unix_ms",
 	"timestamp", "time",
 }
 

internal/session/sidechain_test.go

@@ -476,6 +476,52 @@ func TestLoadSidechainStateAcceptsAdjacentLifecycleSubtypeAliases(t *testing.T)
 	}
 }
 
+func TestLoadSidechainStateAcceptsTimestampAliases(t *testing.T) {
+	sessionPath := filepath.Join(t.TempDir(), "session.jsonl")
+	sessionID := contracts.ID("sess_1")
+	if err := AppendSidechainMessage(sessionPath, sessionID, "timestamp-aliases", TranscriptMessage{
+		Type:      "system",
+		UUID:      "start_1",
+		Timestamp: "2026-01-01T00:00:01Z",
+		Subtype:   "subagent_started",
+		Content: map[string]any{
+			"subagentId":       "timestamp_worker",
+			"startTimestampMs": int64(1710000000123),
+			"status":           "running",
+		},
+	}); err != nil {
+		t.Fatal(err)
+	}
+	if err := AppendSidechainMessage(sessionPath, sessionID, "timestamp-aliases", TranscriptMessage{
+		Type:      "system",
+		UUID:      "summary_1",
+		Timestamp: "2026-01-01T00:00:02Z",
+		Subtype:   "agent_finish",
+		Content: map[string]any{
+			"agentID":              "timestamp_worker",
+			"completedTimestamp":   1710000100,
+			"completedTimestampMs": int64(1710000100456),
+			"resultText":           "timestamp aliases complete",
+		},
+	}); err != nil {
+		t.Fatal(err)
+	}
+
+	state, err := FindSidechainState(sessionPath, sessionID, "timestamp-aliases")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if state.ID != "timestamp_worker" || state.Status != SidechainStatusCompleted || state.Summary != "timestamp aliases complete" {
+		t.Fatalf("state = %#v", state)
+	}
+	if state.StartedAt != "1710000000123" {
+		t.Fatalf("started at = %q", state.StartedAt)
+	}
+	if state.EndedAt != "1710000100" {
+		t.Fatalf("ended at = %q", state.EndedAt)
+	}
+}
+
 func TestLoadSidechainStateAcceptsWrappedLifecycleContent(t *testing.T) {
 	sessionPath := filepath.Join(t.TempDir(), "session.jsonl")
 	sessionID := contracts.ID("sess_1")