Skip to content

feat: add setup epoch compatibility checks#34

Merged
scode merged 1 commit intomainfrom
setup-epochs
Feb 27, 2026
Merged

feat: add setup epoch compatibility checks#34
scode merged 1 commit intomainfrom
setup-epochs

Conversation

@scode
Copy link
Copy Markdown
Owner

@scode scode commented Feb 27, 2026

Introduce setup_soft_epoch and setup_hard_epoch in the soul
frontmatter. The leiter binary has compiled-in expected values for
both. On session start, leiter context compares them:

  • Hard mismatch: blocks the session (soul not injected), tells the
    user what happened and how to fix it.
  • Soft mismatch: nudges with an explanation but still injects the soul.

Both default to 1 when absent from the YAML, so existing souls are
seamlessly compatible.

This lets future leiter upgrades that require user action (e.g.
re-running agent-setup) detect the condition and alert the user,
without needing to bump soul_version or change the soul template.

Introduce setup_soft_epoch and setup_hard_epoch in the soul
frontmatter. The leiter binary has compiled-in expected values for
both. On session start, `leiter context` compares them:

- Hard mismatch: blocks the session (soul not injected), tells the
  user what happened and how to fix it.
- Soft mismatch: nudges with an explanation but still injects the soul.

Both default to 1 when absent from the YAML, so existing souls are
seamlessly compatible.

This lets future leiter upgrades that require user action (e.g.
re-running agent-setup) detect the condition and alert the user,
without needing to bump soul_version or change the soul template.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown
Owner Author

scode commented Feb 27, 2026

This stack of pull requests is managed by Graphite. Learn more about stacking.

@scode scode merged commit 1f6f791 into main Feb 27, 2026
16 checks passed
@scode scode deleted the setup-epochs branch March 4, 2026 04:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant