Files
PaperClipAI/server
DottaandClaude Opus 5.5 54c3616ad9 fix(recovery): ignore the non-assignee comment wake marker in the failed-preparation proof (#21550)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work
> - When a Runner run fails in setup before any provider work, a
person's Retry must start a new run
> - Admission proves "no provider work" for a failed preparation by
checking that the run record holds only known, harmless fields
> - The run profile allowlist did not include
`aiConnectionNonAssigneeCommentWake`, a boolean that dispatch writes
when it admits a run from a non-assignee comment
> - So a run with that marker never passed the proof. Its Retry waited
on `previous_execution_unverified` forever, even after saved-work
recovery finished and the workspace was handed on unchanged
> - This pull request accepts the marker (boolean only) in the proof,
and in the related workspace-wait parent proof
> - The benefit is that these tasks get a working Retry, and a Retry
that was saved earlier starts by itself once the proof passes

## Linked Issues or Issue Description

Refs #21481, #21497.

**What happened?**
On a hosted staging instance, a Runner run failed in setup ("RPC call
environmentExecute timed out") while it prepared. Saved-work recovery
finished ("Saved work recovered."). The workspace was handed on
unchanged for this run. A person pressed Retry two times. Both Retries
waited on `previous_execution_unverified`, and no run started.

**Expected behavior**
A run that failed in setup before any provider work
(`executionRecovery.providerWorkStarted: false`, no process, no
execution events, stopped sandbox) gets a working Retry. A saved Retry
starts by itself when its gate clears.

**Steps to reproduce**
1. Let dispatch admit a Runner run from a non-assignee comment, so the
run profile has `aiConnectionNonAssigneeCommentWake: true`.
2. Make the run fail in setup during preparation.
3. Press Retry. See that the request waits on
`previous_execution_unverified`.

**Paperclip version or commit**
Observed on staging at `e82c4f0a31`; still present on `master` at
`6b631dd477`.

## What Changed

- `server/src/services/cancelled-native-startup.ts`: the
failed-preparation proof accepts `aiConnectionNonAssigneeCommentWake`
when its value is a boolean. The workspace-wait parent proof ignores the
same key.
- `server/src/services/legacy-preparation-retry-hold.test.ts`:
staging-shape tests for a recovered setup failure (failed restore, a
workspace that still names its location, the marker, all together), and
a Retry that attaches to an earlier refused request and then starts.

## Verification

- `cd server && npx vitest run
src/services/legacy-preparation-retry-hold.test.ts`: 12 passed. Without
the fix, the `comment_wake_marker`, `all` and `attached_after_refusal`
cases fail (red), and the other cases pass.
- Focused test file only (the machine was loaded). CI supplies
typecheck, build and the full suite.

## Risks

- Low risk. The marker only records why dispatch admitted the run. Every
other proof clause (no process, no execution events, no native result,
stopped leases, settled preparation evidence, workspace repair) is
unchanged. A non-boolean value still fails the proof.

## Model Used

- Claude Opus 5.5 (`claude-opus-5-5`), via Claude Code with tool use
(shell, file edits, 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-13 22:02:55 -06:00
..