Paperclip Monthly Development Update — June 2026: External Object References, Annotations & Workspace Controls

Paperclip Monthly Update — June 2026

This edition highlights the major changes landed in the paperclipai/paperclip repository during June 2026. If you build on or operate a Paperclip control plane, this issue covers new cross-surface external-object references, annotation and workspace-scoping features, and several pulled-through fixes and dependency bumps.

79 commits were merged in the period. This post covers the most substantial changes from the available commit summaries rather than every individual commit.

External Object References — Status-Aware Links Across the Board

URLs in issues, comments, documents, and related surfaces now resolve to inline status badges instead of remaining plain text links. A new provider-agnostic layer detects known external-work URLs (starting with GitHub), persists normalized references, refreshes status, and renders concise badges across the UI.

Key changes (commit 2dbaf4a7): - Shared contracts, validators, and plugin protocol declarations for external objects - Database schema and additive migrations (external_objects, source_mentions, display metadata) - Server services for detecting, syncing, summarizing, refreshing, and resolving external objects - GitHub provider implementation plus plugin SDK authoring docs - UI rendering across markdown links, comments, issue chat, documents, properties, related work, issue rows, filters, inbox, and sidebar badges - 56 tests across shared, server, and UI packages passing after rebase

Risk note: Cross-surface sync runs via safe wrappers that warn instead of blocking core mutations. Provider-specific URL parsing may miss edge cases; the shared canonicalization test suite covers current GitHub shapes.

Annotation & Workspace Controls

Two complementary PRs landed annotation and workspace-scoping features across the control plane, adding routine description annotations, workspace-operation issue scoping, and Conference Room chat wiring.

Bundle of deployed fixes upstreamed

A batch of fixes and small feature additions that had been deployed to a live instance were rebased and merged upstream (commit e68188c4):

• Document comments: doc-order sort, live updates across clients, surfaced save-failure state, stable markdown selection across re-renders
• Board polling: opt-in summary projection trims oversized heartbeat-run list payloads
• Routine description annotations: comment threads on a routine's description document (mirroring issue document annotations) — new migration 0107, routine_documents schema, routes/service, editable-sections UI
• Workspace operations: workspace_operations.issue_id migration (0106) — associates a workspace operation with the issue that triggered it
• Conference Room chat: selected-agent chat surface and live issue-thread updates
• UI fixes: sidebar nav peek/streamlining, markdown file-viewer re-mount/line-height on iOS Safari, inbox badge/skill deep-link tab selection, ⌘. work-mode cycling on iOS

Standalone migration-bearing PR

A companion PR (commit 746e287e) extracted the highest-risk migration-bearing work for focused review:

• Workspace readiness scoped to blocker issues with attached operation issue IDs
• Issue-thread interaction accept finalization scoped to the source run
• Routine document annotation contracts across db → shared → server → UI
• Document annotation live updates, activity-key normalization, save-failure surfacing, and comment panel improvements
• Compact blocked-by/quick-control UI updates on issue properties
• 273 tests across 10 test files passing

Migration ordering note: Both PRs introduce additive migrations (0106 and 0107). Merge these before any later migration-bearing PR to avoid number collisions.

Dependency & CI Updates

Quick Stats

Highlights from commits merged between June 1–30, 2026. Commit summaries included cover the most impactful changes; not every individual commit is described. Full log at paperclipai/paperclip/commits.