Paperclip Weekly — External Object References, Control Plane Annotations & Workspace Controls (June 22–28, 2026)

Open source control plane for coordinating AI agents, issues, approvals, comments, and work products. This post covers highlights from 57 commits across the week of June 22–28, 2026. Since the full set of commits is larger than the summaries shown here, this is a curated report rather than an exhaustive changelog.

⚡ Who should read this

If you self-host Paperclip, contribute to its plugin system, or manage agent workflows that cross between Paperclip and external tools (GitHub, linear, etc.), this week’s changes touch your day-to-day. Two major feature branches landed alongside several bug-fix batches and dependency bumps.

🧩 External object references across issue surfaces

PR: #8512 — Author: Dotta

One of the biggest pushes this week: URLs to external systems (GitHub issues, PRs, etc.) now appear as inspectable, status-aware objects inside Paperclip instead of bare links.

What changed

• Shared contracts & schema — External-object validators, status helpers, and a plugin protocol declaration live in packages/shared.
• Database layer — Additive migrations for external_objects, source mentions, and display metadata.
• Server — New routes/services for detecting, syncing, refreshing, and resolving external objects across issues, documents, comments, and projects.
• GitHub provider — A reference provider implementation plus plugin SDK authoring docs so others can build providers without touching core.
• UI surfaces — Status badges render inline in markdown links, comments, issue chat, documents, properties, related work, issue rows, filters, inbox, and sidebar. Covered by Storybook stories and component tests.

The feature is company-scoped and provider-extensible — you can write a plugin that detects, say, Linear or Notion URLs without forking core.

🛠️ Control plane annotations and workspace controls (split PR)

PR: #8229 — Author: Dotta

A focused extraction of migration-bearing control-plane work to keep review deterministic.

What changed

• Migrations 0106 & 0107 — Adds workspace_operations.issue_id (scoping workspace operations to their triggering issue) and a routine_documents schema for routine description annotations.
• Annotations on routine descriptions — The same annotation contract that issue documents have now works for routine descriptions, letting operators discuss and edit routine text without special-case infra.
• Workspace readiness scoping — Blocker issues and workspace-operation issue IDs improve how readiness is derived.
• Document comment fixes — Live updates, save-failure surfacing, activity-key normalization, and stable markdown selection across re-renders.

🐛 Upstream deployed fixes (document comments, board perf, chat surface)

PR: #8536 — Author: Dotta

A batch of fixes that had been deployed to a live instance but never landed upstream. Now rebased cleanly on master.

Key fixes

• Document comments — Fixed out-of-order rendering, missing live updates, swallowed save failures, and lost markdown selection on re-render.
• Board polling perf — Added an opt-in summary projection that trims the heartbeat-run list payload.
• Conference Room chat — Wired the selected-agent chat surface with live issue-thread updates (LiveUpdatesProvider).
• UI edge cases — Sidebar nav peek/streamlining, markdown file-viewer re-mount on iOS Safari, inbox badge deep-link tab selection, and ⌘. work-mode cycling on iOS.

📦 Dependency updates

All bumps are minor/patch-level compatibility updates. The claude-agent-acp 0.48.0 release notably adds an agent selection dropdown, fixes duplicate assistant text, and surfaces Bash tool image output.

🧠 Bottom line

• External references turn plain links into first-class objects — huge for agent triage and multi-tool workflows.
• Control-plane annotations land on routines, and workspace operations gain issue scoping.
• A batch of deployed fixes finally lands upstream, converging live and mainline.

Reviewers should note the two new additive migrations (0106, 0107) and the overlap with draft PR #8229 mentioned in the commit notes.

Next newsletter: 2026-06-29