Skip to content

Spec keyed Session instructions for Durable delivery #91

Open

Description

@frap129

What to build

Design the migration from synthetic-message Durable delivery to keyed Session instructions via ctx.session.instructions.entry. The design must cover how Rule identities key instruction entries, how entries are put, listed, and removed, how compaction and reverts affect them, how Matched-rule state stays consistent, and what parts of the delivery ledger and history rebuild can be removed or simplified.

Produce a spec or ADR. Do not implement the migration in this ticket.

Acceptance criteria

  • The spec explains the current synthetic-message Durable delivery flow and why keyed Session instructions are a better fit.
  • The spec defines entry keying, value shape, put/remove behavior, and list usage.
  • The spec defines behavior across compaction, reverts, rule removal, and session resume.
  • The spec identifies changes to the delivery ledger, history rebuild, tests, and user-facing docs.
  • The spec records the migration risks and the rollout order.
  • No implementation is included.

Blocked by

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    v2Part of the opencode v2 migration effort

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions