Skip to content

V2: follow-up cleanup from event schema gang grill #35020

Closed

Description

@opencode-agent

Summary

Follow-up cleanup items from the V2 event-schema gang grill that do not need to block the main schema issue.

Source discussion: https://discord.com/channels/1391832426048651334/1522263729318658181

Items

Step/tool settlement ordering

Background check found local tool settlements can publish after step.ended / step.failed, and callID can repeat across turns. Decide whether this is a bug.

Desired invariant to consider:

step.started
  tool.called
  tool.success | tool.failed
step.ended | step.failed

If enforcing this invariant, publish step settlement only after owned tool fibers settle/finalize.

Compaction checkpoint template headings

Current headings are generic:

## Goal
## Constraints & Preferences
## Progress
## Key Decisions
## Next Steps
## Critical Context
## Relevant Files

Rename to something more OpenCode continuation-checkpoint flavored before beta.

Compaction event payload

Accepted that compaction.ended can keep separate text and recent because they are real checkpoint components: rolling summary and serialized retained tail.

Still clean up projection-only messageID via derived projected IDs if that global direction lands.

Synthetic event shape

Keep synthetic broad/plugin-facing metadata:

session.synthetic { text, description?, metadata? }

This is a valid use of metadata, unlike provider continuation state.

Activity

  1. added
    coreAnything pertaining to core functionality of the application (opencode server stuff)
    gang-grillDesign topics queued for later group grilling
    on Jul 2, 2026
  2. opencode-agent commented on Jul 3, 2026

    @opencode-agent
    ContributorAuthor

    Update: #34919 (fix(core,tui): resolve stuck compacting status with terminal compaction events) covers the compaction terminal-event/TUI stuck-running slice called out by the event/schema audit cleanup.

  3. kitlangton commented on Jul 4, 2026

    @kitlangton
    Contributor

    The remaining body items are consolidated in #35272: tool settlement ordering and continuation-oriented compaction headings. Separate text/recent, derived compaction message IDs, and the accepted synthetic metadata shape are already in place. Failed-compaction terminal handling remains independently tracked by #34919. Keeping this open until #35272 merges.

  4. kitlangton commented on Jul 7, 2026

    @kitlangton
    Contributor

    Completed by #35272, including tool settlement ordering, compaction checkpoint headings, and the finalized synthetic event shape.

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

Metadata

Metadata

Assignees

Labels

2.0coreAnything pertaining to core functionality of the application (opencode server stuff)gang-grillDesign topics queued for later group grilling

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions