Checkpoints v2: Use checkpoint creation time for migration generation calc + lower default generation retention

[computermode]

https://entire.io/gh/entireio/cli/trails/273

• Preserves original checkpoint created_at during v1 to v2 migration so retention age does not reset to migration/write time.
• Updates v2 generation rotation to compute archive timestamps from checkpoint metadata, with raw transcript timestamps as fallback.
• Updates cleanup to recompute v2 generation checkpoint times before trusting generation.json, fixing old migrated data.
• Lowers the default full transcript generation retention from 60 days to 14 days.
• Adds tests covering migration preservation, rotation timestamps, transcript fallback, cleanup eligibility, and settings defaults.
• Updates clean --all to account for remote generation refs as well (based on the retention setting)

➜  entiredb git:(test) entire clean --all

Found 7 items to clean:

Archived v2 generations (7):
  0000000000008
  0000000000009
  0000000000010
  0000000000011
  0000000000012
  0000000000013
  0000000000014

✓ Deleted 7 items:

Archived v2 generations (7):
  0000000000008
  0000000000009
  0000000000010
  0000000000011
  0000000000012
  0000000000013
  0000000000014

---

Note

Medium Risk
Changes retention eligibility for v2 archived transcript generations by switching timestamp sources and reducing the default retention window, which could cause earlier-than-expected cleanup of stored transcripts if timestamp derivation is wrong or metadata is missing.

Overview
V2 checkpoint retention now uses the checkpoint’s original creation time instead of git commit time. WriteCommittedOptions adds CreatedAt, migration passes v1 created_at through, and both v1/v2 committed writers persist created_at via a shared helper.

Generation rotation and cleanup were updated to compute archived generation timestamp ranges by walking checkpoints: prefer v2 /main metadata.json created_at, fall back to parsing timestamp fields from raw transcript events, and only fall back to existing generation.json/commit history when needed.

The default full_transcript_generation_retention_days was lowered from 60 → 14, with tests added/updated to cover created-at preservation, timestamp computation fallbacks, and cleanup eligibility.

^{Reviewed by Cursor Bugbot for commit 22a87cd. Configure here.}

[Copilot]

Pull request overview

This PR updates checkpoints v2 retention and rotation logic so generation age is derived from checkpoint metadata (created_at) rather than migration/commit time, preventing retention windows from being reset during v1→v2 migration or ref repair. It also lowers the default archived full-transcript generation retention window.

Changes:

• Preserve original checkpoint created_at during v1→v2 migration and committed metadata writes.
• Compute archived generation timestamps from checkpoint metadata (with raw transcript timestamp fallback) and use this computation during cleanup eligibility checks.
• Reduce the default full_transcript_generation_retention_days from 60 to 14 and update/add tests accordingly.

Reviewed changes

Copilot reviewed 11 out of 11 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
cmd/entire/cli/strategy/cleanup.go	Uses computed checkpoint timestamps for v2 generation cleanup eligibility, falling back to generation.json when needed.
cmd/entire/cli/settings/settings.go	Lowers the default archived full-transcript generation retention to 14 days.
cmd/entire/cli/settings/settings_test.go	Updates default-retention expectations from 60 to 14 days.
cmd/entire/cli/migrate.go	Preserves v1 checkpoint CreatedAt when writing v2 checkpoints during migration.
cmd/entire/cli/migrate_test.go	Adds a test asserting migration preserves checkpoint CreatedAt.
cmd/entire/cli/clean_test.go	Adds test coverage ensuring retention eligibility uses checkpoint timestamps.
cmd/entire/cli/checkpoint/v2_generation.go	Adds timestamp computation from checkpoint metadata/raw transcript and uses it during rotation.
cmd/entire/cli/checkpoint/v2_generation_test.go	Adds tests for timestamp sourcing from metadata and raw transcript fallback.
cmd/entire/cli/checkpoint/v2_committed.go	Writes committed metadata CreatedAt from provided options (preserving migration timestamps).
cmd/entire/cli/checkpoint/committed.go	Adds a helper to consistently derive CreatedAt (option value or current time).
cmd/entire/cli/checkpoint/checkpoint.go	Introduces WriteCommittedOptions.CreatedAt to carry original checkpoint creation time.

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 22a87cd. Configure here.}