feat(state): checkpoint schema for pipeline execution state#244
Merged
snipcodeit merged 5 commits intomainfrom Mar 6, 2026
Merged
feat(state): checkpoint schema for pipeline execution state#244snipcodeit merged 5 commits intomainfrom
snipcodeit merged 5 commits intomainfrom
Conversation
Add comprehensive Checkpoint Schema section to workflows/state.md that documents the new checkpoint field on issue state objects. Includes field definitions, step-specific progress shapes, forward-compatibility contract, lifecycle diagram, update patterns, and consumer reference. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Extend migrateProjectState() to add a checkpoint field (default: null) to active issue state files. Add initCheckpoint() for creating fresh checkpoint objects and updateCheckpoint() for partial merge updates with append-only artifacts and step_history arrays. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add checkpoint initialization in triage.md (validate_and_load step) and checkpoint update calls at key pipeline stages in execute.md: after planner (plan step), after executor (execute step), and after verifier (verify step). Each checkpoint records step progress, agent output paths, accumulated artifacts, and resume instructions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add plan, summary, and verification artifacts for the checkpoint schema design task. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This was referenced Mar 6, 2026
github-actions
bot
added
slash-commands
snipcodeit
deleted the
issue/235-design-checkpoint-schema-for-pipeline-ex
branch
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.mgw/active/<issue>.jsonstate filesinitCheckpoint()andupdateCheckpoint()functions tolib/state.cjswith append-only artifact tracking and shallow-merge step progressmigrateProjectState()to addcheckpoint: nulldefault to existing active issue filesCloses #235
Milestone Context
Changes
Schema & Documentation (
commands/workflows/state.md)checkpointfield to Issue State Schema (default:null)Implementation (
lib/state.cjs)CHECKPOINT_SCHEMA_VERSION = 1— exported constant for version checkinginitCheckpoint(pipelineStep)— creates fresh checkpoint with defaultsupdateCheckpoint(issueNumber, data)— partial merge updater:migrateProjectState()to add checkpoint field to active issue filesPipeline Integration (
commands/run/triage.md,commands/run/execute.md)Test Plan
initCheckpoint()creates valid structure withschema_version=1updateCheckpoint()correctly merges partial data (scalar merge, step_progress merge)migrateProjectState()adds checkpoint field to all 7 existing active issue files