Skip to content

feat(scripts): add quarterly home-audit hygiene sweep#340

Merged
laurigates merged 1 commit into
mainfrom
feat/home-audit-script
Jul 22, 2026
Merged

feat(scripts): add quarterly home-audit hygiene sweep#340
laurigates merged 1 commit into
mainfrom
feat/home-audit-script

Conversation

@laurigates

Copy link
Copy Markdown
Owner

What

A deterministic $HOME top-level hygiene sweep — scripts/home-audit.sh, exposed as just -g home-audit via a new maint.just module.

Why

Follow-up to the 2026-07 breadth-first $HOME audit (taskwarrior project:home-cleanup). Re-running the full 8-agent classification (~750k tokens) every quarter is wasteful — the enumeration is mechanical and belongs in a script (per offload-to-deterministic-substrate). The recurring reminder triggers this; the human triages a small delta.

How

  • Enumerates in-scope top-level entries (exclusions mirror the audit: caches, macOS dirs, .config, repos//Downloads/).
  • Diffs against a machine-local baseline ($XDG_STATE_HOME/home-audit/baseline.txt); reports NEW_SINCE_BASELINE / GONE_SINCE_BASELINE.
  • Re-flags known-junk patterns every run until removed: empty dirs, backup-suffixed names (*.bak*, *.backup*, *-backup), zero-byte files, node_modules, .DS_Store — with a sentinel allowlist (.hushlogin, .gitkeep…).
  • Emits a compact KEY=VALUE / STATUS=OK|REVIEW rollup. Never deletes.

Verification

  • shellcheck clean.
  • First run initializes the baseline (158 entries); second run correctly reports NEW=0 GONE=0 and flags 19 known-junk candidates.
  • just -g home-audit registered; global justfile parses.

🤖 Generated with Claude Code

Deterministic substrate for the recurring $HOME hygiene reminder
(taskwarrior project:home-cleanup): scripts/home-audit.sh enumerates the
in-scope top-level entries of $HOME, reports the delta since the last run
(baseline in $XDG_STATE_HOME/home-audit/), and flags known-junk patterns
(empty dirs, backup-suffixed names, zero-byte files, node_modules,
.DS_Store) with an allowlist for intentional sentinels (.hushlogin etc.).

Never deletes — it only enumerates and flags, reproducibly, so the human
triages a small delta each cycle instead of re-running the full 8-agent
audit. Out-of-scope names mirror the 2026-07 breadth-first audit
exclusions (caches, macOS dirs, active config, repos/Downloads).

Exposed as `just -g home-audit` via a new maint.just module.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

⚠️ Broken Links Detected

Summary

Status Count
🔍 Total 170
✅ Successful 160
⏳ Timeouts 0
🔀 Redirected 0
👻 Excluded 9
❓ Unknown 0
🚫 Errors 1

Errors per input

Errors in exact_dot_claude/docs/prds/daily-catchup.PRD.md


Please fix the broken links before merging.

@laurigates
laurigates merged commit dc8f533 into main Jul 22, 2026
7 of 8 checks passed
@laurigates
laurigates deleted the feat/home-audit-script branch July 22, 2026 04:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant