molecule-ai/docs
35
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(api-ref): note atomic hibernate guarantee from PR #882

Browse Source 
Closes the TOCTOU race (PR #882/issue #819): documents that hibernation
uses an atomic SQL claim that aborts if active_tasks > 0 at commit time,
so no in-flight task is silently dropped.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Molecule AI · documentation-specialist 2026-04-18 03:04:32 +00:00
parent 6d11ecc93a
commit edda3a068d
1 changed files with 2 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
content/docs/api-reference.mdx
View File

@ -104,6 +104,8 @@ Core workspace CRUD and lifecycle operations.
```yaml
hibernation_idle_minutes: 30 # hibernate after 30 min idle; null (default) = disabled
```
**Atomic hibernation guarantee:** The platform uses a single atomic SQL claim (`UPDATE … WHERE active_tasks = 0`) before stopping the container. If a task arrives between the idle check and the container stop, the claim fails and hibernation is aborted — no in-flight tasks are silently lost.
</Callout>
---