fix(server): keep ready checkpoints when a later placeholder arrives

[Adolanium]

What Changed

The SQL turns projector now refuses a later missing placeholder over a checkpoint that is already ready or error.

In-memory projectEvent already had this guard. SQL always wrote checkpointStatus: event.payload.status. Thread detail and diffs read SQL.

Same-turn placeholder then ready is still the happy path. This only stops a later placeholder from wiping a capture that already landed.

Why

Ingestion and CheckpointReactor dispatch onto the same serial queue. If ready lands first, a later missing was a no-op in memory and a clobber in SQL.

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes (N/A)
• I included a video for animation/interaction changes (N/A)

---

Note

Low Risk
Narrow projection guard on duplicate turn-diff events; improves read-model consistency for checkpoints with limited blast radius.

Overview
Aligns the SQL turn projector with in-memory event projection so a later thread.turn-diff-completed with missing cannot overwrite a turn that already has a real checkpoint (ready or error).

When ready is projected before a trailing placeholder (e.g. shared serial queue ordering), projection_turns used to always take the latest status, so thread detail and diffs could show missing even after a successful capture. The handler now no-ops that downgrade; placeholder-then-ready on the same turn is unchanged.

Adds an integration test that projects ready then missing for the same turn and asserts SQL still stores ready and the checkpoint ref.

^{Reviewed by Cursor Bugbot for commit c5e84c9. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Fix ProjectionPipeline to keep ready checkpoints when a later missing placeholder arrives

• In the thread.turn-diff-completed handler in ProjectionPipeline.ts, adds an early return guard: if an existing turn projection already has a non-null, non-missing checkpointStatus, incoming events with status missing are ignored for that turn.
• Adds a test in ProjectionPipeline.test.ts that projects a ready checkpoint followed by a missing event for the same turn and asserts the ready status and original checkpointRef are retained.

^{Macroscope summarized c5e84c9.}

Summary by CodeRabbit

• Bug Fixes
  • Preserved existing ready checkpoints when a later update reports a missing checkpoint.
  • Prevented valid checkpoint references and associated files from being replaced by a missing status.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: 0931882d-6044-4fe3-81f5-95e4d94af2ad

📥 Commits

Reviewing files that changed from the base of the PR and between 8130a9f and cb2898f.

📒 Files selected for processing (2)

• apps/server/src/orchestration/Layers/ProjectionPipeline.test.ts
• apps/server/src/orchestration/Layers/ProjectionPipeline.ts

Included review availability: Your plan provides up to 10 included reviews per hour; 9 remain after this review.

---

📝 Walkthrough

Walkthrough

The projection pipeline now ignores a later "missing" checkpoint update when the turn already has a real checkpoint. A regression test verifies that the existing status and reference remain unchanged.

Changes

Checkpoint preservation

Layer / File(s)	Summary
Preserve projected checkpoints apps/server/src/orchestration/Layers/ProjectionPipeline.ts, apps/server/src/orchestration/Layers/ProjectionPipeline.test.ts	The projection returns early for a "missing" update when a real checkpoint already exists. The regression test verifies that the "ready" status and original checkpoint reference remain stored.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Bug fix

Suggested reviewers: t3dotgg

Merge Risk: ⚪ Minimal · up to cb289

The projection preserves completed checkpoints when later placeholder events arrive, with regression coverage for the ready-to-missing sequence. The change is ready to merge.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 2…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title clearly and concisely describes the main fix: preserving ready checkpoints when a later missing placeholder arrives.
Description check	✅ Passed	The description includes the required What Changed, Why, and Checklist information. It explains the SQL projector bug, the intended behavior, the unchanged placeholder-then-ready flow, and the test co…

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

Approvability

Verdict: Approved at c5e84c9

Macroscope's review found this PR approvable — This is a narrow read-model consistency fix: only a later missing checkpoint event is ignored when a real checkpoint already exists, preserving the stored status and git reference. The accompanying integration test covers the affected ordering, with no schema or cross-cutting runtime changes.

^{You can add or adjust custom eligibility rules. Learn more.}

[juliusmarminge]

@coderabbitai review

[coderabbitai]

⚠️ Action not completed

Already reviewed the last commit. Use @coderabbitai full review to rerun a review of the entire changeset.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.