Files
PaperClipAI/packages/plugins
DottaandClaude Opus 5.5 482063aeca fix(daytona): reuse or repair a read-only skill bundle instead of failing the sync (#21075)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work
> - Agent turns run in a remote Runner in a Daytona sandbox. Before a
turn starts, Paperclip copies each selected skill into the sandbox as a
read-only bundle.
> - A sandbox is often kept between turns, so the read-only bundle is
already there when the next turn (or a recovery) copies it again.
> - The server writes the same skill files again on its own disk, with
new timestamps. The copy compared the bundles with `tar --diff`, which
also compares timestamps. So the copy saw a difference, extracted over
the read-only directories, and failed with "Cannot open: File exists".
> - The turn then stopped and the task stayed blocked until a person
sent a message.
> - This pull request treats a timestamp-only difference as the same
bundle, and repairs a bundle that really differs instead of failing.
> - The benefit is that a kept sandbox no longer blocks a task when its
skills are copied again.

## Linked Issues or Issue Description

**What happened?**
On staging, two tasks in 30 minutes stopped with "Daytona syncIn extract
command failed (exit 43): tar: .paperclip-repository/...: Cannot open:
File exists". One failure was a normal new turn on a kept sandbox. The
other was a recovery of an interrupted turn. Neither one started again
by itself.

**Expected behavior**
The turn uses the bundle that is already in the sandbox when its content
and permissions match. When the content does not match, the copy repairs
it.

**Steps to reproduce**
1. Copy a read-only (0555/0444) skill directory into a sandbox.
2. Change only the timestamps of the copy (this is what a new server
preparation does).
3. Copy the same skill again. GNU tar fails with "Cannot open: File
exists".

## What Changed

- `file-sync.ts` (read-only directory copy): run the `tar --diff` check
with `LC_ALL=C` and ignore lines that only say "Mod time differs".
Bytes, modes, file types and missing files still count as differences.
- When the bundle really differs, make its read-only subdirectories
writable before the extract. GNU tar then replaces the files and
restores the archived directory modes (`--delay-directory-restore`).
Extra files in the target stay.
- If reopening the directories or the repair extract fails, re-seal only
the directories that were reopened for it (their list is recorded
first). Writable user directories beside the bundle keep their modes.
- `file-sync.test.ts`: the existing GNU tar test now covers a
timestamp-only resync (kept, no failure) and a damaged bundle (repaired
to the source bytes and modes, instead of the old fail-closed result),
and a repair that cannot finish (bundle directories re-sealed to 0555, a
writable user directory left at 0755), and a reopen that hits an
unreadable user directory (bundle re-sealed, no scratch files left).

## Verification

- Red: with the old `file-sync.ts`, the updated test fails with the same
error seen on staging: `tar: references/overview.md: Cannot open: File
exists`.
- Green: `npx vitest run src/file-sync.test.ts` in
`packages/plugins/sandbox-providers/daytona` passes 33/33 with GNU tar.
- I reproduced the root cause by hand with GNU tar 1.35: a re-extract
over a 0555 directory fails with "Cannot open: File exists", and `tar
-df` reports only "Mod time differs" for a copy that differs only in
timestamps.

## Risks

- Low risk. The change affects only read-only (immutable) directory
copies on Daytona.
- A bundle that really differs is now repaired in place instead of
failing the turn. Each file is replaced by tar (unlink and create). The
directory modes come back from the archive.
- If a target has extra read-only subdirectories that are not in the
archive, they become owner-writable after a repair.

> For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and
discuss it in `#dev` before opening the PR. Feature PRs that overlap
with planned core work may need to be redirected — check the roadmap
first. See `CONTRIBUTING.md`.

## Model Used

- Claude Opus 5.5 (`claude-opus-5-5`), Claude Code agent with tool use
(shell, code search, test execution).

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [ ] All Paperclip CI gates are green
- [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 06:28:27 -06:00
..