Skip to content

Add workspace cleanup reference to docs site #473

@sergeyklay

Description

@sergeyklay

M21 introduces a configurable workspace cleanup policy (#204 ADR + #205 implementation) that removes orphaned workspace directories on a retention schedule. Operators running long-lived Sortie deployments need a reference page explaining the cleanup behavior, config fields, and interaction with existing workspace lifecycle points.

Scope: document the configured strategy (TTL-based or whatever #204 selects), the workspace.retention_days field (default, valid range, zero-disable semantics), the cleanup scan cadence, the interaction with the before_remove hook from the existing workspace config, and the safety guarantees (active/retrying issues preserved, unmappable directories skipped). Include a worked example showing before/after disk usage for a typical long-running deployment. Cross-link to the workspace section of architecture.md and to the existing workspace hooks reference.

Depends on #204 (ADR) and #205 (implementation).

Verify: a workspace cleanup section is added to the existing workspace reference page on docs.sortie-ai.com (or published as its own reference page if that fits better). All config fields are documented with defaults. Safety guarantees are stated explicitly.

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:docs-sitedocs.sortie-ai.com content and infrastructurearea:workspaceWorkspace creation, hooks, path safety, cleanup

    Type

    Projects

    Status

    Todo

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions