aboutsummaryrefslogtreecommitdiff
path: root/assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-20 14:48:49 -0400
committerCraig Jennings <c@cjennings.net>2026-05-20 14:48:49 -0400
commitc24174f811ad5ffca1a3454013b55127df50ff3c (patch)
tree7ba34eb6462cf46efb352c1c0dbc7a4daa70ce17 /assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt
parent926a9a3e34557b259394c25ca8d10c675438515d (diff)
downloadarchsetup-c24174f811ad5ffca1a3454013b55127df50ff3c.tar.gz
archsetup-c24174f811ad5ffca1a3454013b55127df50ff3c.zip
chore: clean dead todo.org doc-links and file three docs to outbox
I removed three dead `file:` links in todo.org. They pointed at docs that were never written: testing-strategy.org, firmware-cleanup.org, and PLAN-browser-themes.org. Each task body already carries that content inline, so the links were dead weight. I also reworded the Testinfra task's lead-in that claimed the testing-strategy doc exists. I filed three resolved reference docs into assets/outbox/: the calendar-sync scrub note, the tmux copy-mode handoff, and the 2026-05-19 lint follow-up report.
Diffstat (limited to 'assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt')
-rw-r--r--assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt80
1 files changed, 80 insertions, 0 deletions
diff --git a/assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt b/assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt
new file mode 100644
index 0000000..a167e77
--- /dev/null
+++ b/assets/outbox/2026-05-13-calendar-sync-local-into-dotfiles.txt
@@ -0,0 +1,80 @@
+calendar-sync.local.el into common/.emacs.d/
+=============================================
+
+Date: 2026-05-13
+Machine: laptop (this one)
+
+What was done
+-------------
+
+Added dotfiles/common/.emacs.d/calendar-sync.local.el. The real
+file lives under common/ and is symlinked back into ~/.emacs.d/
+on this machine:
+
+ ~/.emacs.d/calendar-sync.local.el
+ -> ~/code/archsetup/dotfiles/common/.emacs.d/calendar-sync.local.el
+
+A matching template, calendar-sync.local.el.example, was checked
+into the dotemacs repo so future setups know what shape the file
+needs to take. The .example file is tracked in dotemacs;
+calendar-sync.local.el itself is gitignored in dotemacs (entry
+already present at .gitignore:54).
+
+Why
+---
+
+On 2026-05-04, commit cc594fd ("Make calendar sync startup safe
+without config") in the dotemacs repo refactored
+modules/calendar-sync.el to stop hard-coding the calendar feed
+URLs inline. The new design loads them from a private file at
+~/.emacs.d/calendar-sync.local.el. That file is gitignored in
+dotemacs, so it never propagates across machines via the dotemacs
+checkout.
+
+This laptop never got the file created. M-x calendar-sync-now
+failed with "calendar-sync: No calendars configured". State file
+(data/calendar-sync-state.el) showed last successful sync at
+2026-05-01 16:57, three days before the refactor landed --
+confirming the gap.
+
+Putting the file under common/ in archsetup means GNU Stow
+distributes it the same way every other dotfile is distributed:
+make stow links it into $HOME on each machine.
+
+Heads-up for archsetup
+----------------------
+
+The file contains real private .ics feed URLs (Google personal,
+Proton, Google work). It is currently TRACKED in archsetup --
+.gitignore was not modified to exclude it, because the whole
+point of putting it under common/ is for it to flow to other
+machines via git pull + make restow.
+
+The archsetup remote is git@cjennings.net:archsetup.git only --
+your private server, no public mirror -- so exposure is bounded
+to that host. Same URLs are already in dotemacs git history on
+both cjennings.net and the github.com mirror anyway (from
+cc594fd^). The dotemacs URLs were left in place by choice.
+
+If you ever change your mind on tracking, the move is:
+ 1. Regenerate the .ics secret addresses in each calendar's UI.
+ 2. Add dotfiles/common/.emacs.d/calendar-sync.local.el to
+ archsetup/.gitignore.
+ 3. Distribute the file out-of-band (manual copy, age-encrypted,
+ pass, whatever).
+
+While here: inbox/ was root-owned (since 2026-04-10) and
+unwritable as cjennings, blocking note creation. Ran:
+ sudo chown -R cjennings:cjennings ~/code/archsetup/inbox/
+to normalize. No idea what set it to root originally -- probably
+a sudo-driven install step. Worth flagging if it returns.
+
+Action items
+------------
+
+- Decide whether to commit common/.emacs.d/calendar-sync.local.el
+ in archsetup (recommended) or pull it into a separate private
+ channel.
+- On every other machine: pull archsetup, run `make restow
+ <de>`, restart Emacs. The symlink should appear and the next
+ M-x calendar-sync-now will work.