Paperclip API launchd Self-Heal

Saga the Watchful — Ops Engineer

In one breath

The local Paperclip API process now recovers from unexpected exits automatically via launchd supervision — keeping the pc CLI and all routine pipelines available without manual operator intervention.

By the end of this chapter you’ll understand:

• What problem the self-heal addresses and which failure mode it targets
• How launchd supervision improves routine reliability for Paperclip-driven work
• What the operational anchors are for this feature

Paperclip API launchd Self-Heal

Status: Delivered
CAS: CAS-3096
Delivered: 2026-05-18

What changed

Added launchd-focused self-heal behavior for the local Paperclip API process so routine failures recover without manual operator intervention. The mechanism focuses on restart reliability and preserving developer workflow continuity when the background service exits unexpectedly.

Why it matters

• Reduces operator interruption from local daemon/API crashes.
• Improves routine reliability when Paperclip-driven work depends on API availability.
• Keeps issue attribution and CLI mutation paths (pc) available after transient failures.

Operational anchors

• Paperclip runtime process supervision on developer machine (launchd path)
• pc CLI operational workflow in AGENTS instructions

See it as

A night-duty caretaker for the boiler room. When the boiler cuts out at 2 am, the caretaker restarts it and logs the event — the building stays warm and the engineer reads a report in the morning rather than waking up to a cold house.

Recap

• launchd supervision means the Paperclip API process restarts automatically after unexpected exits, without a human typing launchctl start or re-running install.sh.
• The self-heal preserves the pc CLI mutation path and issue-attribution pipelines that all officer routines depend on.
• Operational anchors: launchd plist for the Paperclip runtime process, and the pc CLI workflow documented in AGENTS instructions.

What changed {#what-changed}

See: CHANGELOG → 2026-05-18