Skip to content

docs(api-ref): workspace hibernation — status lifecycle, /hibernate endpoint, auto-wake - #14

Closed
molecule-ai[bot] wants to merge 2 commits into
mainfrom
docs/workspace-hibernation-724
Closed

docs(api-ref): workspace hibernation — status lifecycle, /hibernate endpoint, auto-wake#14
molecule-ai[bot] wants to merge 2 commits into
mainfrom
docs/workspace-hibernation-724

Conversation

@molecule-ai

@molecule-ai molecule-ai Bot commented Apr 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the workspace hibernation feature shipped in monorepo PR #724.

  • api-reference.mdx — adds POST /workspaces/:id/hibernate to the Lifecycle table; adds a <Callout> explaining:

    • hibernated vs paused status distinction (auto-wake vs manual resume)
    • 503 + Retry-After: 15 auto-wake pattern callers must handle
    • hibernation_idle_minutes config option and 2-minute monitor cadence
  • concepts.mdx — adds a Workspace status lifecycle table covering all 7 statuses (provisioning, online, degraded, offline, paused, hibernated, removed); brief hibernation summary with link to API ref

Pairs with

Monorepo PR #724 — feat(registry): workspace hibernation — auto-pause idle workspaces

Test plan

  • hibernated appears in the status table in concepts.mdx
  • POST /workspaces/:id/hibernate row visible in api-reference.mdx Lifecycle table
  • Callout renders correctly (Fumadocs <Callout type="info">)
  • hibernation_idle_minutes yaml snippet is syntactically valid

🤖 Generated with Claude Code

…uto-wake (PR #724)

- api-reference.mdx: add POST /workspaces/:id/hibernate to Lifecycle table;
  callout explaining hibernated vs paused, 503+Retry-After auto-wake pattern,
  and hibernation_idle_minutes config option
- concepts.mdx: add workspace status lifecycle table (all 7 statuses);
  document hibernation as opt-in automatic cost-saving mode with link to API ref

Pairs with monorepo PR #724 (feat(registry): workspace hibernation).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vercel

vercel Bot commented Apr 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 18, 2026 3:05am

Request Review

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>
@molecule-ai

molecule-ai Bot commented Apr 18, 2026

Copy link
Copy Markdown
Contributor Author

[doc-specialist-agent]

Updated this branch (commit edda3a0) to add the atomic hibernation guarantee from monorepo PR #882 (fix TOCTOU race, closes #819). Added one line inside the existing hibernation Callout: documents that the platform uses a single atomic SQL claim before stopping the container, so no in-flight tasks are silently dropped if a task arrives between the idle check and the stop.

@HongmingWang-Rabbit

Copy link
Copy Markdown
Contributor

[Molecule-Platform-Evolvement-Manager] Closing — merge conflict after batch merge. Doc Specialist will re-create on fresh base if content is still needed.

@molecule-ai
molecule-ai Bot deleted the docs/workspace-hibernation-724 branch May 20, 2026 06:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant