[DOCS] `cleanupPeriodDays` setting docs omit tool result files from cleanup scope

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

cleanupPeriodDays row in the settings table, and "Automatic cleanup" bullet in sub-agents docs

Current Documentation

From settings.md, the cleanupPeriodDays setting describes deleting inactive sessions (transcripts / .jsonl files).

From sub-agents.md: "Transcripts are cleaned up based on the cleanupPeriodDays setting (default: 30 days)."

Both descriptions mention only transcripts. Neither mentions that tool result files are also governed by this setting.

What's Wrong or Missing?

Claude Code v2.1.83 fixed a bug where tool result files were never being cleaned up despite the cleanupPeriodDays setting. The fix confirms that tool result files are intended to be part of the cleanup scope, but the docs describe only session transcripts.

After the fix, users may be surprised to find tool result files being cleaned up that they didn't know were subject to this setting. The docs give an incomplete picture of what cleanupPeriodDays controls.

Suggested Improvement

In settings.md, expand the cleanupPeriodDays description:

Sessions inactive for longer than this period are deleted at startup (default: 30 days). This includes session transcripts (.jsonl files) and any tool result files associated with those sessions.

In sub-agents.md, update the "Automatic cleanup" bullet:

Automatic cleanup: Transcripts and associated tool result files are cleaned up based on the cleanupPeriodDays setting (default: 30 days).

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | cleanupPeriodDays row in settings table |
| https://code.claude.com/docs/en/sub-agents | "Automatic cleanup" bullet under transcript persistence |

Total scope: 2 pages affected

Source: Changelog v2.1.83

Fixed tool result files never being cleaned up, ignoring the cleanupPeriodDays setting