Constantine and cucurigoo
2f1c0e011e
fix(hermes): surface silent nonzero exit failures ( #10107 )
...
## Thinking Path
- Followed a silent nonzero Hermes exit from child-process result
parsing through heartbeat run, runtime, task-session, and agent
finalization.
- Found two gaps: the adapter could return `errorMessage: null` for a
numeric nonzero exit, and heartbeat later reused the nullable adapter
field instead of its normalized fallback.
- Kept timeout, signal-cancellation, and specific parsed diagnostics
authoritative.
## Linked Issue(s) / Bug Report
Related to #9751 (stderr classification) and #9519 (exit-zero
finalization), but this is a separate failure mode.
Reproduction: run Hermes with a child result equivalent to `exitCode:
1`, `timedOut: false`, and no parsed diagnostic. The heartbeat row
derives `Adapter failed`, while runtime/task-session/agent finalization
can persist null diagnostics.
## What Changed
- Give silent numeric nonzero Hermes exits a stable fallback such as
`Hermes exited with code 1`.
- Preserve specific parsed errors and timeout/signal semantics.
- Reuse the normalized persisted run error for recovered runtime state,
task-session `lastError`, and agent `errorReason`.
- Add adapter-level and embedded-Postgres regressions.
## Verification
- Hermes adapter `execute.onspawn.test.ts` — 7 passed.
- Focused heartbeat normalized-error regression — 1 passed (91 skipped).
- `pnpm --filter @paperclipai/hermes-paperclip-adapter typecheck` —
passed.
- `pnpm --filter @paperclipai/server typecheck` — passed.
- `git diff --check origin/master...HEAD` — passed.
Independent review also ran the full recovery file: the changed
regression passed; one unrelated pre-existing timing-sensitive test
timed out.
## Risks / Rollout Notes
Low risk. Fallback text is used only when a numeric nonzero exit has no
better diagnostic. Existing timeout, signal, and parsed-error precedence
remains unchanged.
## Model Used
OpenAI Codex `gpt-5.6-sol` with repository inspection, test execution,
and independent read-only review.
## 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 (not
applicable: internal diagnostics only)
- [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
- [ ] I will address all Greptile and reviewer comments before
requesting merge
Co-authored-by: cucurigoo <cucurigoo@users.noreply.github.com >
2026-08-12 16:09:35 -07:00
..
2026-08-07 14:29:58 -07:00
2026-08-04 20:45:42 -05:00
2026-05-23 09:09:40 -05:00
2026-05-22 08:12:52 -05:00
2026-04-17 09:44:19 -05:00
2026-08-05 23:40:05 -05:00
2026-08-04 23:07:38 -05:00
2026-07-07 06:28:54 -05:00
2026-07-09 16:29:30 -05:00
2026-07-31 13:15:42 -05:00
2026-07-27 19:11:51 -05:00
2026-07-27 18:58:31 -07:00
2026-07-14 15:07:30 -05:00
2026-07-08 19:05:03 -07:00
2026-08-04 23:07:38 -05:00
2026-07-09 16:29:30 -05:00
2026-07-09 13:08:56 -05:00
2026-07-09 13:08:56 -05:00
2026-07-14 15:53:09 -07:00
2026-08-12 08:58:25 -07:00
2026-07-09 16:29:30 -05:00
2026-03-23 19:43:50 -05:00
2026-06-06 12:45:57 -05:00
2026-08-05 21:49:40 -05:00
2026-07-27 19:11:51 -05:00
2026-06-25 09:49:10 -05:00
2026-08-05 21:49:40 -05:00
2026-03-18 14:21:50 -05:00
2026-08-07 00:42:08 -05:00
2026-08-04 10:31:14 -07:00
2026-07-23 13:30:26 -07:00
2026-07-09 16:29:30 -05:00
2026-06-18 21:26:36 -07:00
2026-07-14 14:22:39 -05:00
2026-07-10 16:04:29 -05:00
2026-05-22 08:12:52 -05:00
2026-04-15 08:41:15 -05:00
2026-04-15 09:47:29 -05:00
2026-07-14 15:53:09 -07:00
2026-07-09 16:29:30 -05:00
2026-04-24 15:11:42 -05:00
2026-07-21 10:47:33 -07:00
2026-08-04 13:54:40 -05:00
2026-04-24 15:11:42 -05:00
2026-08-04 19:37:08 -05:00
2026-08-11 14:39:23 -04:00
2026-07-14 15:53:09 -07:00
2026-07-14 15:53:09 -07:00
2026-07-23 13:30:26 -07:00
2026-07-27 19:08:07 -05:00
2026-07-14 14:22:39 -05:00
2026-06-11 16:32:55 -05:00
2026-06-02 17:13:29 -07:00
2026-05-19 14:25:58 -05:00
2026-08-10 12:47:03 -07:00
2026-05-27 21:15:01 -10:00
2026-07-06 16:33:36 -05:00
2026-07-15 20:03:52 -05:00
2026-07-25 10:06:28 -07:00
2026-07-09 16:29:30 -05:00
2026-08-11 09:06:21 -07:00
2026-07-22 20:35:51 -07:00
2026-07-09 22:11:03 -05:00
2026-07-09 16:29:30 -05:00
2026-07-08 19:05:03 -07:00
2026-05-03 11:30:48 -05:00
2026-07-14 15:07:30 -05:00
2026-06-20 21:58:44 -07:00
2026-07-14 15:07:30 -05:00
2026-06-02 17:13:29 -07:00
2026-07-28 15:38:01 -07:00
2026-08-04 23:00:14 -05:00
2026-08-04 23:00:14 -05:00
2026-07-14 15:49:36 -07:00
2026-08-12 08:58:25 -07:00
2026-08-12 08:58:25 -07:00
2026-07-08 19:05:03 -07:00
2026-03-20 08:50:00 -05:00
2026-07-24 16:40:47 -05:00
2026-04-24 14:15:28 -05:00
2026-06-20 21:58:44 -07:00
2026-07-30 11:37:00 -07:00
2026-07-30 11:37:00 -07:00
2026-08-12 16:08:49 -07:00
2026-07-27 19:13:35 -05:00
2026-07-30 11:37:00 -07:00
2026-08-04 23:00:14 -05:00
2026-08-11 16:06:37 -07:00
2026-08-10 17:01:33 -07:00
2026-08-04 23:00:14 -05:00
2026-08-10 17:01:33 -07:00
2026-07-15 21:44:21 -05:00
2026-07-15 21:44:21 -05:00
2026-07-09 19:32:58 -05:00
2026-07-09 19:32:58 -05:00
2026-07-15 11:42:40 -05:00
2026-07-15 11:42:40 -05:00
2026-07-15 11:42:40 -05:00
2026-07-09 13:08:56 -05:00
2026-07-16 15:50:45 -05:00
2026-04-24 07:37:13 -05:00
2026-07-15 11:42:40 -05:00
2026-07-30 15:29:31 -07:00
2026-08-07 00:42:08 -05:00
2026-08-02 10:55:36 -05:00
2026-08-11 15:25:07 -07:00
2026-04-17 09:44:19 -05:00
2026-08-07 00:41:19 -05:00
2026-07-14 15:53:09 -07:00
2026-08-04 13:17:49 -05:00
2026-08-04 23:02:51 -05:00
2026-04-29 16:12:06 -07:00
2026-06-20 21:58:44 -07:00
2026-06-20 21:58:44 -07:00
2026-07-07 20:30:09 -05:00
2026-08-09 20:20:09 -05:00
2026-08-02 10:47:03 -05:00
2026-08-02 10:47:03 -05:00
2026-07-17 12:17:34 -05:00
2026-07-31 19:17:02 -07:00
2026-08-05 09:55:01 -05:00
2026-04-06 21:23:33 -05:00
2026-04-20 06:08:55 -05:00
2026-06-01 22:03:51 +00:00
2026-08-02 10:37:10 -05:00
2026-05-19 15:52:39 -05:00
2026-08-07 18:30:16 -07:00
2026-07-30 21:34:45 -07:00
2026-08-04 13:54:40 -05:00
2026-06-29 13:26:26 -05:00
2026-05-15 08:54:55 -05:00
2026-06-30 14:50:25 -07:00
2026-04-24 18:03:41 -07:00
2026-07-03 16:44:21 -07:00
2026-07-03 16:44:21 -07:00
2026-07-10 14:32:47 -07:00
2026-08-07 14:29:58 -07:00
2026-08-11 11:40:57 -07:00
2026-06-23 08:27:19 -05:00
2026-07-10 14:32:47 -07:00
2026-08-12 11:32:15 -07:00
2026-07-25 08:29:26 -05:00
2026-06-20 09:42:53 -07:00
2026-08-07 14:29:58 -07:00
2026-07-09 13:08:56 -05:00
2026-08-11 11:40:57 -07:00
2026-04-24 12:15:53 -07:00
2026-08-12 16:05:53 -05:00
2026-06-11 16:39:47 -07:00
2026-08-11 11:40:57 -07:00
2026-07-09 18:19:49 -05:00
2026-08-12 10:21:00 -07:00
2026-07-30 11:37:00 -07:00
2026-04-24 15:11:42 -05:00
2026-08-04 23:02:51 -05:00
2026-08-02 20:24:52 -07:00
2026-05-20 10:37:11 -05:00
2026-06-23 08:27:19 -05:00
2026-04-03 15:59:42 -05:00
2026-08-11 12:11:45 -04:00
2026-05-27 21:15:01 -10:00
2026-07-16 15:50:45 -05:00
2026-07-16 15:50:45 -05:00
2026-07-08 19:05:03 -07:00
2026-06-10 19:10:29 -07:00
2026-07-08 19:05:03 -07:00
2026-06-20 21:58:44 -07:00
2026-08-02 22:14:58 -07:00
2026-07-14 15:07:30 -05:00
2026-06-20 21:58:44 -07:00
2026-07-31 11:46:34 -07:00
2026-08-04 23:00:14 -05:00
2026-07-29 14:23:12 -07:00
2026-07-05 05:58:20 -05:00
2026-08-05 21:49:40 -05:00
2026-06-06 12:45:57 -05:00
2026-07-09 18:19:49 -05:00
2026-07-31 18:53:53 -07:00
2026-07-24 16:35:07 -05:00
2026-08-01 07:15:52 -07:00
2026-07-22 11:53:29 -05:00
2026-08-04 13:54:40 -05:00
2026-08-04 13:17:49 -05:00
2026-07-22 13:05:28 -05:00
2026-06-23 09:00:14 -05:00
2026-07-14 15:07:30 -05:00
2026-06-11 23:31:39 -07:00
2026-08-02 22:14:58 -07:00
2026-07-27 19:11:51 -05:00
2026-07-24 09:58:58 -05:00
2026-08-12 16:09:35 -07:00
2026-07-31 18:36:36 -07:00
2026-07-29 17:12:22 -07:00
2026-07-31 13:31:17 -07:00
2026-07-29 14:23:12 -07:00
2026-07-29 14:23:12 -07:00
2026-08-07 07:23:56 -07:00
2026-07-14 22:40:38 -07:00
2026-07-23 20:52:42 -07:00
2026-04-20 06:01:49 -05:00
2026-07-21 15:16:26 -05:00
2026-07-27 19:45:59 -05:00
2026-07-02 22:21:56 -07:00
2026-07-09 13:08:56 -05:00
2026-07-31 17:30:41 -07:00
2026-04-24 15:50:32 -05:00
2026-07-27 22:01:29 -05:00
2026-08-07 18:41:52 -07:00
2026-08-12 11:29:51 -07:00
2026-07-29 14:23:12 -07:00
2026-08-01 16:04:43 -05:00
2026-08-07 09:06:36 -07:00
2026-08-04 13:54:40 -05:00
2026-06-11 21:54:32 -07:00
2026-04-04 14:04:33 -05:00
2026-04-20 06:08:55 -05:00
2026-07-20 17:17:08 -05:00
2026-07-16 16:49:18 -05:00
2026-08-11 13:23:03 -04:00
2026-07-10 17:09:57 -05:00
2026-07-27 18:58:31 -07:00
2026-07-22 19:48:43 -07:00
2026-08-11 11:40:57 -07:00
2026-08-11 11:40:57 -07:00
2026-08-06 22:31:15 -07:00
2026-05-25 07:25:26 -05:00
2026-06-26 22:11:16 -05:00
2026-04-24 15:11:42 -05:00
2026-04-17 09:44:19 -05:00
2026-07-09 16:29:30 -05:00
2026-04-17 09:44:19 -05:00
2026-04-17 09:44:19 -05:00
2026-06-26 22:11:16 -05:00
2026-07-15 11:42:40 -05:00
2026-07-14 15:47:58 -07:00
2026-04-24 15:11:42 -05:00
2026-04-24 15:50:32 -05:00
2026-07-14 15:47:58 -07:00
2026-08-04 13:17:49 -05:00
2026-08-04 23:02:51 -05:00
2026-07-16 17:00:53 -05:00
2026-08-04 13:17:49 -05:00
2026-07-21 10:47:33 -07:00
2026-08-05 15:59:01 -05:00
2026-07-14 15:53:09 -07:00
2026-07-09 13:08:56 -05:00
2026-08-04 23:02:51 -05:00
2026-08-04 12:51:06 -05:00
2026-08-06 10:29:07 -05:00
2026-08-05 23:40:05 -05:00
2026-05-09 22:18:12 -07:00
2026-07-16 17:00:53 -05:00
2026-08-04 12:51:06 -05:00
2026-08-04 12:51:06 -05:00
2026-08-05 23:40:05 -05:00
2026-08-01 15:43:13 -07:00
2026-08-04 12:51:06 -05:00
2026-03-24 11:48:59 -05:00
2026-06-11 17:59:32 -07:00
2026-08-11 14:39:23 -04:00
2026-08-05 15:59:01 -05:00
2026-08-12 16:08:40 -07:00
2026-08-04 13:54:40 -05:00
2026-07-16 09:24:38 -05:00
2026-08-12 10:42:58 -07:00
2026-08-07 18:41:52 -07:00
2026-04-21 10:02:52 -05:00
2026-08-04 13:54:40 -05:00
2026-08-05 23:40:05 -05:00
2026-08-04 13:17:49 -05:00
2026-07-14 15:53:09 -07:00
2026-08-04 13:17:49 -05:00
2026-08-05 23:12:41 -05:00
2026-07-14 15:53:09 -07:00
2026-08-04 13:17:49 -05:00
2026-08-11 14:39:23 -04:00
2026-08-11 14:39:23 -04:00
2026-08-04 12:51:06 -05:00
2026-07-14 15:53:09 -07:00
2026-04-23 14:51:46 -05:00
2026-06-09 21:57:21 -05:00
2026-08-04 13:54:40 -05:00
2026-07-14 15:53:09 -07:00
2026-07-31 21:55:59 -07:00
2026-08-02 10:37:10 -05:00
2026-08-04 13:54:40 -05:00
2026-08-04 20:45:42 -05:00
2026-08-04 20:45:42 -05:00
2026-08-11 14:39:23 -04:00
2026-04-17 09:44:19 -05:00
2026-07-28 10:50:13 -07:00
2026-08-12 11:22:50 -07:00
2026-06-26 16:04:58 -05:00
2026-03-20 08:50:00 -05:00
2026-08-11 14:39:23 -04:00
2026-08-04 23:02:51 -05:00
2026-07-27 12:00:21 -07:00
2026-07-14 15:07:30 -05:00
2026-08-05 16:34:04 -05:00
2026-06-06 12:45:57 -05:00
2026-06-11 17:59:32 -07:00
2026-08-11 15:25:07 -07:00
2026-06-23 16:32:15 -07:00
2026-06-22 10:34:13 -05:00
2026-06-20 21:58:44 -07:00
2026-04-29 15:56:17 -07:00
2026-08-04 12:51:06 -05:00
2026-06-11 21:52:43 -07:00
2026-07-17 14:18:01 -05:00
2026-06-20 21:58:44 -07:00
2026-06-20 21:58:44 -07:00
2026-06-30 07:52:40 -07:00
2026-07-05 05:58:20 -05:00
2026-08-05 10:09:17 -05:00
2026-07-23 20:52:42 -07:00
2026-07-23 09:34:42 -07:00
2026-08-11 19:10:45 -07:00
2026-05-12 17:38:24 -05:00
2026-07-29 12:50:16 -07:00
2026-06-30 09:57:49 -07:00
2026-07-14 14:03:03 -05:00
2026-08-06 22:31:15 -07:00
2026-07-15 18:01:44 -05:00
2026-07-22 20:48:41 -07:00
2026-07-22 20:48:41 -07:00
2026-05-20 10:37:11 -05:00
2026-05-17 17:15:06 -05:00
2026-05-05 07:42:57 -05:00
2026-07-24 16:47:24 -05:00
2026-05-10 07:34:12 -05:00
2026-08-11 14:39:23 -04:00
2026-07-14 15:07:30 -05:00
2026-07-28 10:50:13 -07:00
2026-05-05 07:42:57 -05:00
2026-05-05 07:42:57 -05:00
2026-07-22 21:30:34 -07:00
2026-07-14 12:57:20 -05:00
2026-07-01 11:39:39 -07:00
2026-06-12 10:17:19 -07:00
2026-06-03 19:13:21 -07:00
2026-07-14 15:07:30 -05:00
2026-08-07 14:29:58 -07:00
2026-04-14 13:34:52 -05:00
2026-08-11 14:39:23 -04:00
2026-08-10 17:00:32 -07:00
2026-07-01 11:39:39 -07:00
2026-06-06 09:17:27 -05:00
2026-06-06 09:17:27 -05:00
2026-06-05 16:48:02 -05:00
2026-07-24 07:19:58 -07:00
2026-07-05 05:58:20 -05:00
2026-03-16 15:11:01 -05:00
2026-07-14 22:40:38 -07:00
2026-04-24 15:50:32 -05:00
2026-05-03 08:58:53 -05:00
2026-08-04 13:54:40 -05:00
2026-08-07 07:23:56 -07:00
2026-07-15 11:42:40 -05:00
2026-08-04 13:17:49 -05:00
2026-07-14 15:07:30 -05:00
2026-08-07 00:54:43 -05:00
2026-07-27 19:13:35 -05:00
2026-07-23 15:49:28 -05:00
2026-07-14 15:53:09 -07:00
2026-07-05 05:58:20 -05:00
2026-07-24 16:47:24 -05:00
2026-07-14 15:53:09 -07:00
2026-08-12 16:09:00 -07:00
2026-05-19 13:46:02 -05:00
2026-07-10 13:21:12 -05:00
2026-08-06 10:29:07 -05:00
2026-06-20 14:03:21 -07:00
2026-06-22 19:35:53 -07:00
2026-08-05 21:49:40 -05:00
2026-05-09 18:22:17 -05:00
2026-07-22 08:04:39 -05:00
2026-07-23 13:30:26 -07:00
2026-07-31 16:46:26 -07:00
2026-07-15 20:03:52 -05:00
2026-07-10 07:44:08 -05:00
2026-08-05 21:49:40 -05:00
2026-07-05 05:58:20 -05:00
2026-07-01 13:43:11 -07:00
2026-04-24 15:11:42 -05:00
2026-06-19 09:14:41 -07:00
2026-07-14 15:07:30 -05:00
2026-06-05 16:48:02 -05:00
2026-05-25 07:25:26 -05:00
2026-07-24 16:44:56 -05:00
2026-07-24 16:44:56 -05:00
2026-05-30 20:51:46 +00:00
2026-07-17 11:03:07 -05:00
2026-08-11 08:56:32 -04:00
2026-07-25 08:34:41 -05:00
2026-07-25 08:34:41 -05:00
2026-06-05 12:55:49 -05:00
2026-06-05 12:55:49 -05:00
2026-06-05 12:55:49 -05:00
2026-07-21 09:25:58 -05:00
2026-07-21 15:16:26 -05:00
2026-08-12 16:09:18 -07:00
2026-07-14 14:22:39 -05:00
2026-07-27 19:04:46 -05:00
2026-07-24 16:29:47 -07:00
2026-07-21 15:16:26 -05:00
2026-06-05 16:48:02 -05:00
2026-06-12 10:37:55 -07:00
2026-07-10 16:11:26 -05:00
2026-04-21 20:15:11 -05:00
2026-07-25 10:06:28 -07:00
2026-04-20 06:08:55 -05:00
2026-03-17 10:12:44 -05:00
2026-07-30 21:40:57 -07:00
2026-08-02 10:37:10 -05:00
2026-08-02 10:37:10 -05:00
2026-06-05 16:48:02 -05:00
2026-08-07 14:26:40 -05:00
2026-08-07 00:41:19 -05:00
2026-07-14 15:53:09 -07:00