Lab #4572: Docs: document garbageCollection.autoDefinitions and the run gc changes from swamp-club#4299

swamp-club#4299 (PR swamp-club/swamp#3703) added an opt-in garbageCollection.autoDefinitions: <duration> key. It removes idle auto-definitions in the automatic retention passes and in swamp run gc. The manual doesn't cover it, and three passages are now inaccurate.

Now inaccurate:

reference/repository-configuration.md, garbageCollection → "Never removed" lists "Definitions, vaults and .swamp.yaml". Auto-definitions are removed when autoDefinitions is set.
reference/operational-commands.md, swamp run gc: --older-than is described as overriding the .swamp.yaml defaults, but it never applies to autoDefinitions. The JSON output table also lacks autoDefinitionsDeleted and autoDefinitions ([{name, type}]), and the preview lacks autoDefinitionsToDelete and autoDefinitions.
reference/behavior-definitions.md, .swamp/auto-definitions/: it implies these files are kept for good. It should say they can be removed by retention.

To add:

A #### garbageCollection.autoDefinitions section in repository-configuration.md, beside data, audit and bookkeeping:
- It is opt-in only and never set by the shared retention.
- It removes an auto-definition only when its type is not exempt, it has no data versions and no method outputs, no workflow names it literally (modelIdOrName or modelName), and its file is older than the cutoff.
- Data and outputs are the real idle signal, so a definition's data and outputs must expire first. Usually that means data retention is set as well.
- Removing one discards global arguments set with swamp behavior edit, and the next run by name creates a new definition with a new id.
- Workflow steps named by an expression, and per-worker lane definitions, are not protected by the reference check.
- A run that looked a definition up before retention removed it fails with definition_changed_under_lock; running it again succeeds.
how-to/operational-tasks/configure-retention.md: a short opt-in step after "Opt in to data retention", for repositories where each workflow run gets its own behavior name.
explanation/data-lifetimes.md, "Repository retention": one line on why auto-definition removal is opt-in.

In-repo reference: design/surfaces/repo.md (Retention, "Auto-definitions").

workflow history get: show the username for who decided an approval, not just user:<id>

datastore push: a dropped push after a reported-success run isn't persisted (run still exits 0); a wedged push holds the datastore lock until the process is killed

swamp issue: choose the target collective and control issue visibility -- at filing time and afterward -- from the CLI (with a settable default)

Render <details>/<summary> in serve's report view

Schedule catch-up counts slots before the watermark across a DST fall-back in the host timezone

A corrupt extension lockfile prints a stack trace instead of a clean error

stagecraft DESIGN.md: say the stored-as-received check catches only a redacted secret, and --literal-inputs is what stops evaluation

Lazy loading: delete compile.ts --no-bundle once a Deno version bump has shipped bundled

swamp extension update writes an upgraded extension's skills into a skill directory another extension owns

stagecraft: dispatch prompts read injected products by latest record, not the version the run indexed

Respect dependency versions pinned with extension pull dep@version

Docs: swamp serve reload now applies scheduling, the scheduled-run limit and timed-service on/off

Docs: hot-reload manual page lists which serve settings reload, including grant settings and admin removal

Find a working-directory Swamp repo even with `SWAMP_SERVE_URL` in the environment

Docs: swamp serve reload now applies most serve.yaml settings without --hot-reload or a restart

Scheduled flaky-test detection is failing

datastore setup extension over serve: resolve --config expressions with per-caller authorization

serve: add a fitness test so no serve route is added under the /hooks/ webhook route-file prefix

Audit OAuth client deletion

Collective-registered OAuth clients can't complete authorization_code: redirect URIs are stored as a JSON array string

Docs: team members' CLI retries reads refused during a serve failover, and the new recovery failure code

software-factory: a work item whose slug extends another's reads the other's records

Docs: document garbageCollection.autoDefinitions and the run gc changes from swamp-club#4299

Docs: catalogue the audit actions swamp serve records

Docs: manual page for swamp workflow schedule list and pause

Extension versions: print one spelling in log output (drop the v prefix in list, outdated, update, search)

Ambient tags: set tags once per repo/worktree (env or .swamp), add them to every run and everything downstream, filter run history by tag

Allow editing recent feed submissions

GCP codegen: StateData inferred from StateSchema may hit TS2589 now that nested state objects are .partial()

No way to add or switch to password login on an account created with SSO

Native interactive report views in the dashboard, with scoped workflow refresh

Rename a behavior type (e.g. move it to another namespace) without losing its data

data.latest(): catch a name that equals its spec name before run time, and say how to fix it

Studio Board orders stage columns by position within each tracker-status lane, not by process order

Expose a manual_approval gate's decision identity (decidedBy) to workflow expressions

data query rejects CEL list macros: exists(c, ...) fails with Unknown field "c"

A workflow run keeps every step's resource contents in memory, so a large forEach fan-out can exhaust the heap

Image factory: golden GCE and Docker base images built on ops

swamp data get and data versions report Behavior not found for data whose behavior definition was deleted

Workflow-scoped data get reports the behavior id as modelName once the behavior definition is deleted

Slackwater: let customers build integrations that drive workflows securely and auditably

Container run inspection and isolation metadata for audited recovery tests

GCP codegen: generate media upload/download from Discovery mediaUpload and supportsMediaDownload

@swamp/video: describe and chapters for a joined video

swamp serve: apply config changes without failed requests (full reload, vault-backed webhook secrets, harmless restarts)

stagecraft tracker: tidy up external relations (duplicate entries, id case, second lookup)

SWAMP_SERVER_TOKEN does not authenticate with --server, while --token and SWAMP_SERVER_TOKEN_FILE do

Terminal title should be conversation summary

@swamp/issue-lifecycle: collapse the verification_passed, post_attestation, link_pr sequence

@swamp/issue-lifecycle: one-call verification

Relationships

#4572 Docs: document garbageCollection.autoDefinitions and the run gc changes from swamp-club#4299

Open