From 961c8e9875b257faa136add082bb168a43830d0f Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 30 Dec 2025 17:59:48 +0000 Subject: [PATCH] docs: update safe-outputs documentation for dynamic maintenance scheduling MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updates safe-outputs.md to reflect the dynamic maintenance scheduling feature introduced in PR #8190. The maintenance workflow now runs at different frequencies based on the shortest expiration time across all workflows, rather than running daily as previously documented. Changes: - Updated Auto-Expiration section with dynamic frequency breakdown - Updated Discussion Creation section to reference dynamic scheduling - Removed outdated references to "daily" maintenance workflow Related: #8190 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 --- docs/src/content/docs/reference/safe-outputs.md | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/docs/src/content/docs/reference/safe-outputs.md b/docs/src/content/docs/reference/safe-outputs.md index 0d03e2b53f..471de54f46 100644 --- a/docs/src/content/docs/reference/safe-outputs.md +++ b/docs/src/content/docs/reference/safe-outputs.md @@ -94,7 +94,14 @@ safe-outputs: #### Auto-Expiration -The `expires` field auto-closes issues after a time period. Supports integers (days) or relative formats: `2h`, `7d`, `2w`, `1m`, `1y`. Generates daily `agentics-maintenance.yml` workflow to close expired items. Note: Hours less than 24 are treated as 1 day minimum since the maintenance workflow runs daily. +The `expires` field auto-closes issues after a time period. Supports integers (days) or relative formats: `2h`, `7d`, `2w`, `1m`, `1y`. Generates `agentics-maintenance.yml` workflow that runs at the minimum required frequency based on the shortest expiration time across all workflows: + +- 1 day or less → every 2 hours +- 2 days → every 6 hours +- 3-4 days → every 12 hours +- 5+ days → daily + +Hours less than 24 are treated as 1 day minimum for expiration calculation. #### Temporary IDs for Issue References @@ -388,7 +395,7 @@ safe-outputs: ### Discussion Creation (`create-discussion:`) -Creates discussions with optional `category` (slug, name, or ID; defaults to first available). `expires` field auto-closes after period (integers or `2h`, `7d`, `2w`, `1m`, `1y`, hours < 24 treated as 1 day) as "OUTDATED" with comment. Generates daily maintenance workflow. +Creates discussions with optional `category` (slug, name, or ID; defaults to first available). `expires` field auto-closes after period (integers or `2h`, `7d`, `2w`, `1m`, `1y`, hours < 24 treated as 1 day) as "OUTDATED" with comment. Generates maintenance workflow with dynamic frequency based on shortest expiration time (see Auto-Expiration section above). ```yaml wrap safe-outputs: