diff --git a/docs/superpowers/evidence/reflector-dns-retry-2026-11-20.json b/docs/superpowers/evidence/reflector-dns-retry-2026-11-20.json new file mode 100644 index 00000000..9391a6b8 --- /dev/null +++ b/docs/superpowers/evidence/reflector-dns-retry-2026-11-20.json @@ -0,0 +1,19 @@ +{ + "intent": "reflector.service no longer stays in systemctl --failed after a boot where DNS comes up after network-online.target.", + "scope": ["linux_configuration/periodic_background/setup_periodic_system.sh", "drop-in source lives in kuhyx/system-maintenance systemd/reflector.service.d/retry-on-dns.conf"], + "changes": ["setup_periodic_system.sh installs the reflector Restart=on-failure drop-in next to periodic-system-startup.service"], + "verification": [ + { + "command": "bash tests/test_boot_dns_retry.sh (system-maintenance)", + "result": "pass", + "evidence": "red before the drop-in existed, then PASS for both units and systemd-analyze verify" + }, + { + "command": "shellcheck linux_configuration/periodic_background/setup_periodic_system.sh", + "result": "pass", + "evidence": "no findings" + } + ], + "risks": ["Installer aborts if ~/src/system-maintenance is not pulled first (install -D on a missing template)"], + "rollback": ["git revert; rm /etc/systemd/system/reflector.service.d/retry-on-dns.conf; systemctl daemon-reload"] +} diff --git a/docs/superpowers/evidence/token-audit-subagent-labels-2026-10-10.json b/docs/superpowers/evidence/token-audit-subagent-labels-2026-10-10.json deleted file mode 100644 index fd972689..00000000 --- a/docs/superpowers/evidence/token-audit-subagent-labels-2026-10-10.json +++ /dev/null @@ -1,31 +0,0 @@ -{ - "intent": "Every subagent in the token audit carries a task label and type; no '?' / 'unknown' rows in the subagent tables.", - "scope": [ - "python_pkg/token_audit/discover.py, python_pkg/token_audit/parse.py and their tests", - "Non-goal: no hook or settings.json change; every Agent launch already records a description" - ], - "changes": [ - "agent_meta borrows a missing description/type from the same agent-.meta.json in another session dir (background agents that outlive /clear continue in the new session's subagents/ with no meta)", - "load_session falls back to the first user prompt line (60 chars), then '(no label) agent-', instead of '?'" - ], - "verification": [ - { - "command": "python3 -m pytest -q python_pkg/token_audit/tests --cov=python_pkg.token_audit --cov-branch", - "result": "pass", - "evidence": "200 passed, 100.00% branch coverage" - }, - { - "command": "python3 -m python_pkg.token_audit --since 1791123199.748 --until 1791627950.749 --no-write", - "result": "pass", - "evidence": "Same window as the 2026-10-10 snapshot: 'unknown' ($35.23) and '?' ($35.93) rows gone; all 14 affected files labelled from the spawning session's meta" - } - ], - "risks": [ - "Agent ids colliding across sessions would borrow the wrong label (ids are 17 random hex chars; none seen across 479 files)", - "One extra glob over projects/*/*/subagents per unlabelled subagent file" - ], - "rollback": [ - "git revert the commit", - "Re-run the audit with --no-write and confirm the old '?' row returns" - ] -} diff --git a/linux_configuration/periodic_background/setup_periodic_system.sh b/linux_configuration/periodic_background/setup_periodic_system.sh index e0200973..e30c9d45 100755 --- a/linux_configuration/periodic_background/setup_periodic_system.sh +++ b/linux_configuration/periodic_background/setup_periodic_system.sh @@ -160,6 +160,8 @@ create_startup_service() { local startup_service="/etc/systemd/system/periodic-system-startup.service" install -m 0644 "$TEMPLATE_STARTUP" "$startup_service" echo "✓ Installed startup service from template: $startup_service" + # Boot-time network units race DNS here; both retry instead of staying failed. + install -D -m 0644 "$SYSTEMD_TEMPLATES/reflector.service.d/retry-on-dns.conf" /etc/systemd/system/reflector.service.d/retry-on-dns.conf } # Function to create hosts file monitor service