Skip to content

t3277: wire upstream_watch config keys and document JSONC config for all numeric intervals #4630

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marcusquinn merged 1 commit into from
Mar 14, 2026
Merged

t3277: wire upstream_watch config keys and document JSONC config for all numeric intervals #4630

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .agents/configs/aidevops-config.schema.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,17 @@
"default": 24,
"minimum": 1,
"description": "Hours between OpenClaw update checks. Env: AIDEVOPS_OPENCLAW_FRESHNESS_HOURS"
},
"upstream_watch": {
"type": "boolean",
"default": true,
"description": "Automatically check upstream repos for new releases. Env: AIDEVOPS_UPSTREAM_WATCH"
},
"upstream_watch_hours": {
"type": "integer",
"default": 24,
"minimum": 1,
"description": "Hours between upstream repo watch checks. Env: AIDEVOPS_UPSTREAM_WATCH_HOURS"
}
},
"additionalProperties": false
Expand Down
10 changes: 9 additions & 1 deletion .agents/configs/aidevops.defaults.jsonc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,15 @@

// Hours between OpenClaw update checks.
// Env override: AIDEVOPS_OPENCLAW_FRESHNESS_HOURS
"openclaw_freshness_hours": 24
"openclaw_freshness_hours": 24,

// Automatically check upstream repos (inspiration/borrowed-from) for new releases.
// Env override: AIDEVOPS_UPSTREAM_WATCH
"upstream_watch": true,

// Hours between upstream repo watch checks.
// Env override: AIDEVOPS_UPSTREAM_WATCH_HOURS
"upstream_watch_hours": 24
},

// ---------------------------------------------------------------------------
Expand Down
59 changes: 35 additions & 24 deletions .agents/scripts/auto-update-helper.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,17 +26,21 @@
# auto-update-helper.sh help Show this help
#
# Configuration:
# AIDEVOPS_AUTO_UPDATE=true|false Override enable/disable (env var)
# AIDEVOPS_UPDATE_INTERVAL=10 Minutes between checks (default: 10)
# AIDEVOPS_SKILL_AUTO_UPDATE=false Disable daily skill freshness check
# AIDEVOPS_SKILL_FRESHNESS_HOURS=24 Hours between skill checks (default: 24)
# AIDEVOPS_OPENCLAW_AUTO_UPDATE=false Disable daily OpenClaw update check
# AIDEVOPS_OPENCLAW_FRESHNESS_HOURS=24 Hours between OpenClaw checks (default: 24)
# AIDEVOPS_TOOL_AUTO_UPDATE=false Disable 6-hourly tool freshness check
# AIDEVOPS_TOOL_FRESHNESS_HOURS=6 Hours between tool checks (default: 6)
# AIDEVOPS_TOOL_IDLE_HOURS=6 Required user idle hours before tool updates (default: 6)
# AIDEVOPS_UPSTREAM_WATCH=false Disable daily upstream repo watch check
# AIDEVOPS_UPSTREAM_WATCH_HOURS=24 Hours between upstream watch checks (default: 24)
# All values can be set via JSONC config (aidevops config set <key> <value>)
# or overridden per-session via environment variables (higher priority).
#
# JSONC key Env override Default
# updates.auto_update AIDEVOPS_AUTO_UPDATE true
# updates.update_interval_minutes AIDEVOPS_UPDATE_INTERVAL 10
# updates.skill_auto_update AIDEVOPS_SKILL_AUTO_UPDATE true
# updates.skill_freshness_hours AIDEVOPS_SKILL_FRESHNESS_HOURS 24
# updates.openclaw_auto_update AIDEVOPS_OPENCLAW_AUTO_UPDATE true
# updates.openclaw_freshness_hours AIDEVOPS_OPENCLAW_FRESHNESS_HOURS 24
# updates.tool_auto_update AIDEVOPS_TOOL_AUTO_UPDATE true
# updates.tool_freshness_hours AIDEVOPS_TOOL_FRESHNESS_HOURS 6
# updates.tool_idle_hours AIDEVOPS_TOOL_IDLE_HOURS 6
# updates.upstream_watch AIDEVOPS_UPSTREAM_WATCH true
# updates.upstream_watch_hours AIDEVOPS_UPSTREAM_WATCH_HOURS 24
#
# Logs: ~/.aidevops/logs/auto-update.log

Expand Down Expand Up @@ -924,7 +928,7 @@
local needs_check=true
if [[ -n "$last_upstream_check" ]]; then
local last_epoch now_epoch elapsed
if [[ "$(uname)" == "Darwin" ]]; then

Check warning on line 931 in .agents/scripts/auto-update-helper.sh

View check run for this annotation

SonarQubeCloud / SonarCloud Code Analysis

Define a constant instead of using the literal 'Darwin' 7 times. 


See more on https://sonarcloud.io/project/issues?id=marcusquinn_aidevops&issues=AZzq7F4PpV0X0E10gUAL&open=AZzq7F4PpV0X0E10gUAL&pullRequest=4630
last_epoch=$(TZ=UTC date -j -f "%Y-%m-%dT%H:%M:%SZ" "$last_upstream_check" "+%s" 2>/dev/null || echo "0")
else
last_epoch=$(date -d "$last_upstream_check" "+%s" 2>/dev/null || echo "0")
Expand Down Expand Up @@ -1564,16 +1568,22 @@
logs --follow Follow log output in real-time
help Show this help

ENVIRONMENT:
AIDEVOPS_AUTO_UPDATE=false Disable auto-update (overrides scheduler)
AIDEVOPS_UPDATE_INTERVAL=10 Minutes between checks (default: 10)
AIDEVOPS_SKILL_AUTO_UPDATE=false Disable daily skill freshness check
AIDEVOPS_SKILL_FRESHNESS_HOURS=24 Hours between skill checks (default: 24)
AIDEVOPS_OPENCLAW_AUTO_UPDATE=false Disable daily OpenClaw update check
AIDEVOPS_OPENCLAW_FRESHNESS_HOURS=24 Hours between OpenClaw checks (default: 24)
AIDEVOPS_TOOL_AUTO_UPDATE=false Disable 6-hourly tool freshness check
AIDEVOPS_TOOL_FRESHNESS_HOURS=6 Hours between tool checks (default: 6)
AIDEVOPS_TOOL_IDLE_HOURS=6 Required user idle hours before tool updates (default: 6)
CONFIGURATION:
Persistent settings: aidevops config set <key> <value>
Per-session overrides: set the corresponding environment variable.

JSONC key Env override Default
updates.auto_update AIDEVOPS_AUTO_UPDATE true
updates.update_interval_minutes AIDEVOPS_UPDATE_INTERVAL 10
updates.skill_auto_update AIDEVOPS_SKILL_AUTO_UPDATE true
updates.skill_freshness_hours AIDEVOPS_SKILL_FRESHNESS_HOURS 24
updates.openclaw_auto_update AIDEVOPS_OPENCLAW_AUTO_UPDATE true
updates.openclaw_freshness_hours AIDEVOPS_OPENCLAW_FRESHNESS_HOURS 24
updates.tool_auto_update AIDEVOPS_TOOL_AUTO_UPDATE true
updates.tool_freshness_hours AIDEVOPS_TOOL_FRESHNESS_HOURS 6
updates.tool_idle_hours AIDEVOPS_TOOL_IDLE_HOURS 6
updates.upstream_watch AIDEVOPS_UPSTREAM_WATCH true
updates.upstream_watch_hours AIDEVOPS_UPSTREAM_WATCH_HOURS 24

SCHEDULER BACKENDS:
macOS: launchd LaunchAgent (~/Library/LaunchAgents/com.aidevops.aidevops-auto-update.plist)
Expand Down Expand Up @@ -1612,9 +1622,10 @@
RATE LIMITS:
GitHub API: 60 requests/hour (unauthenticated)
10-min interval = 6 requests/hour (well within limits)
Skill check: once per 24h per user (configurable via AIDEVOPS_SKILL_FRESHNESS_HOURS)
OpenClaw check: once per 24h per user (configurable via AIDEVOPS_OPENCLAW_FRESHNESS_HOURS)
Tool check: once per 6h per user, only when idle (configurable via AIDEVOPS_TOOL_FRESHNESS_HOURS)
Skill check: once per 24h per user (configurable via updates.skill_freshness_hours)
OpenClaw check: once per 24h per user (configurable via updates.openclaw_freshness_hours)
Tool check: once per 6h per user, only when idle (configurable via updates.tool_freshness_hours)
Upstream watch: once per 24h per user (configurable via updates.upstream_watch_hours)

LOGS:
~/.aidevops/logs/auto-update.log
Expand Down
4 changes: 4 additions & 0 deletions .agents/scripts/config-helper.sh
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -292,6 +292,8 @@ _config_env_map() {
updates.tool_idle_hours) echo "AIDEVOPS_TOOL_IDLE_HOURS" ;;
updates.openclaw_auto_update) echo "AIDEVOPS_OPENCLAW_AUTO_UPDATE" ;;
updates.openclaw_freshness_hours) echo "AIDEVOPS_OPENCLAW_FRESHNESS_HOURS" ;;
updates.upstream_watch) echo "AIDEVOPS_UPSTREAM_WATCH" ;;
updates.upstream_watch_hours) echo "AIDEVOPS_UPSTREAM_WATCH_HOURS" ;;
orchestration.supervisor_pulse) echo "AIDEVOPS_SUPERVISOR_PULSE" ;;
orchestration.repo_sync) echo "AIDEVOPS_REPO_SYNC" ;;
orchestration.max_workers_cap) echo "AIDEVOPS_MAX_WORKERS_CAP" ;;
Expand Down Expand Up @@ -357,6 +359,8 @@ _legacy_key_to_dotpath() {
tool_idle_hours) echo "updates.tool_idle_hours" ;;
openclaw_auto_update) echo "updates.openclaw_auto_update" ;;
openclaw_freshness_hours) echo "updates.openclaw_freshness_hours" ;;
upstream_watch) echo "updates.upstream_watch" ;;
upstream_watch_hours) echo "updates.upstream_watch_hours" ;;
manage_opencode_config) echo "integrations.manage_opencode_config" ;;
manage_claude_config) echo "integrations.manage_claude_config" ;;
supervisor_pulse) echo "orchestration.supervisor_pulse" ;;
Expand Down
Loading