Skip to content

docs(readme): add docs-tidy; fix LaunchAgents placement note #11

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
twistedmelonman merged 1 commit into from
Oct 21, 2026
Merged

docs(readme): add docs-tidy; fix LaunchAgents placement note #11

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
10 changes: 6 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,10 @@ Internal repo; not intended for public consumption.
failing, so `allup` still passes on a machine that legitimately lacks one.
A repo that fails its status check, switch, pull or branch restore makes
the walker exit 1; a dirty repo is skipped and does not.
- LaunchAgent plists that invoke these scripts live in
`~/Developer/LaunchAgents/`, not in this repo. The empty `LaunchAgents/`
directory here is a placeholder.
- LaunchAgent plists for scripts in this repo live in `LaunchAgents/` here
and are symlinked into `~/Library/LaunchAgents/`. Plists for scripts
outside any repo live in `~/Developer/LaunchAgents/`. `CLAUDE.md` has the
full placement rule.
- Practice/standards reference: `CLAUDE.md` (same dir). Design docs:
`docs/plans/`.

Expand Down Expand Up @@ -55,6 +56,7 @@ Internal repo; not intended for public consumption.
| Script | Purpose |
| --- | --- |
| `smb-mount.sh` | Idempotent SMB auto-mounter for the ASIAGO workstation. Mounts `romano` via `mount_smbfs` + 1Password, and `mimolette` via `osascript 'mount volume'` (routes through Apple-ID SSO / NetAuth) + managed `~/workspaces` symlink. LaunchAgent cadence 150 s. Design: [`docs/plans/2026-04-16-smb-mount-rebuild-design.md`](docs/plans/2026-04-16-smb-mount-rebuild-design.md). |
| `docs-tidy.py` | Quarterly `~/Documents` tidy, plan then approve. `plan` writes a plan to `~/.local/state/docs-tidy/`: archive items unchanged for four calendar years to Google Drive, de-duplicate `Documents - <HOST>` machine snapshots, stash duplicate files, and rename and tag credit reports. Nothing moves until `docs-tidy apply` (copy, verify MD5, delete; `--skip SECTION`). `show` prints the newest plan. Python, stdlib only. Runs under `LaunchAgents/com.asiago.docs-tidy.plist` (`plan --notify`, 10:00 on Jan/Apr/Jul/Oct 1). Design: [`docs/plans/2026-10-21-docs-tidy-design.md`](docs/plans/2026-10-21-docs-tidy-design.md). Tests in `tests/docs-tidy.bats`. |
| `check-certs.sh` | Given a hostname list (defaults to `/tmp/dns-names.txt`), reports DNS resolution and HTTPS certificate validity for each. |

### Credentials & automation
Expand Down Expand Up @@ -89,7 +91,7 @@ Internal repo; not intended for public consumption.
`my-repos.sh` and `beacon-repos.sh`.
- `docs/plans/` — design docs and specs for non-trivial scripts.
- `tests/` — `bats` test suites and fixtures (`ssh-wrapper.bats`).
- `LaunchAgents/` — placeholder only; active plists live in `~/Developer/LaunchAgents/`.
- `LaunchAgents/` — plists for scripts in this repo, symlinked into `~/Library/LaunchAgents/` (see `CLAUDE.md`).
- `.github/workflows/` — `claude-blocking-review.yml`, `dependabot-auto-merge.yml` (PR-review automation and dependabot auto-merge). Scheduled ralph-burndown automation moved to a LaunchAgent on mimolette.local.

## Standards
Expand Down
Loading