Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

fix(handoff): use transcript chronology for Codex briefs (#846)

Rudy Mizrahi Celeklic2177b590421
diff --git a/cli/beacon/internal/handoff/brief_test.go b/cli/beacon/internal/handoff/brief_test.go
index a0518b44..078ae7a9 100644
--- a/cli/beacon/internal/handoff/brief_test.go
+++ b/cli/beacon/internal/handoff/brief_test.go
@@ -494,3 +494,42 @@ func TestLogSessionCanonicalizesAnAliasedHarness(t *testing.T) {
t.Fatalf("--harness must find rows written under the alias: %+v, %v, %v", session, found, err)
}
}
+
+func TestCodexBriefUsesTranscriptTimeAfterOlderRolloutIsTouched(t *testing.T) {
+ testenv.SetHome(t, t.TempDir())
+ f := newStoreFixture(t)
+ f.writeTranscripts(t)
+ older := filepath.Join(f.dirs[HarnessCodex], "sessions", "2026", "09", "20", "rollout-2026-09-20T09-00-00-codex-thread-1.jsonl")
+ data, err := os.ReadFile(older)
+ if err != nil {
+ t.Fatal(err)
+ }
+ writeFixture(t, older, strings.ReplaceAll(string(data), "2026-09-21T09:", "2026-09-20T09:"))
+ // Copying or touching an old transcript must not make its requests newer.
+ setModTime(t, older, codexUpdated.Add(time.Hour))
+ sources := DefaultSources(f.dirs)
+ session, err := Find(sources, HarnessCodex, "codex-thread-1")
+ if err != nil {
+ t.Fatal(err)
+ }
+ events, err := Events(sources, session)
+ if err != nil {
+ t.Fatal(err)
+ }
+ brief := BuildBrief(session, events, FromSessionStore, briefNow)
+ if brief.FirstRequest != "fix the login form" || brief.LatestRequest != "also check the signup form" || brief.LastMessage != "The form validates now." {
+ t.Fatalf("handoff inverted durable conversation chronology: first=%q latest=%q reply=%q", brief.FirstRequest, brief.LatestRequest, brief.LastMessage)
+ }
+ started := 0
+ for _, event := range events {
+ if event.Event.Action == "session.started" {
+ started++
+ if !strings.HasPrefix(event.Timestamp, "2026-09-20T") {
+ t.Fatalf("session start chosen from later rollout: %s", event.Timestamp)
+ }
+ }
+ }
+ if started != 1 {
+ t.Fatalf("session starts = %d, want one", started)
+ }
+}
diff --git a/cli/beacon/internal/handoff/events.go b/cli/beacon/internal/handoff/events.go
index 964b471a..35b54c25 100644
--- a/cli/beacon/internal/handoff/events.go
+++ b/cli/beacon/internal/handoff/events.go
@@ -67,8 +67,8 @@ func claudeEvents(mapped []claudesession.MappedEvent) []schema.Event {
return events
}
-// Events reads every rollout file of the thread, oldest first, so a thread resumed into a new file
-// keeps its earlier turns.
+// Events reads every rollout file of the thread, ordering mapped activity by
+// durable event timestamps so touching an older file cannot invert its turns.
func (s *codexSource) Events(session Session) ([]schema.Event, error) {
store, err := s.store()
if err != nil {
@@ -89,17 +89,32 @@ func (s *codexSource) Events(session Session) ([]schema.Event, error) {
}
sort.SliceStable(thread, func(i, j int) bool { return thread[i].ModTimeUnixMS < thread[j].ModTimeUnixMS })
var events []schema.Event
- for i, ref := range thread {
+ for _, ref := range thread {
records, _, err := store.Read(ref)
if err != nil {
return nil, err
}
- // A later rollout file repeats the thread's session_meta; only the first starts the session.
- for _, m := range codexsession.MapSession(ref, records, codexsession.MapOptions{SkipSessionStarted: i > 0}) {
+ for _, m := range codexsession.MapSession(ref, records, codexsession.MapOptions{}) {
events = append(events, m.Event)
}
}
- return events, nil
+ // The mapper renders every timestamp in fixed-width UTC form, making its
+ // byte order chronological. Keep source order for simultaneous activity.
+ sort.SliceStable(events, func(i, j int) bool { return events[i].Timestamp < events[j].Timestamp })
+ // Resumed rollouts repeat session_meta. Keep only the earliest mapped start
+ // after sorting, rather than choosing it by the file's modification time.
+ out := events[:0]
+ started := false
+ for _, event := range events {
+ if event.Event.Action == "session.started" {
+ if started {
+ continue
+ }
+ started = true
+ }
+ out = append(out, event)
+ }
+ return out, nil
}
func (s *openCodeSource) Events(session Session) ([]schema.Event, error) {