Update TODO: pi agent Bun --compile problem persists as of 2026-07-24

Bun 1.3.14 is still the latest release and still fails on this system
(kernel 7.0.14, glibc 2.39). Upstream pi (now 0.82.0) continues to
build with a broken Bun, so the npm-install-build-system workaround
is still needed.

[scripts] Derive main project from worktree path in merge-worktree.

[tests] Simplify test code: extract shared assertion helpers, trim vps-base.scm.

- Add tests/common.scm with assert-service-running and
  assert-binary-exists helpers, DRYing patterns repeated
  across 6 per-component test files.
- Remove unnecessary let block from %test-vps — test
  functions already have descriptive names.
- Inline single-use os binding in run-vps-test.

Co-Authored-By: Claude <noreply@anthropic.com>

[hooks] Allow git push from main project after merge.

[ai] Refine merge-worktree: shorter, tighter, DRY, fix detached-HEAD detection.

[paseo] Update package hash.

Co-Authored-By: Claude <noreply@anthropic.com>

[vps] Add dnscrypt-proxy.

Package dnscrypt-proxy 2.1.7 with Shepherd service and
resolv-conf-service-type that extends etc-service-type.
Wire into vps-operating-system (dedicated user/group,
resolver pointing at 127.0.0.1).  Test dnscrypt-proxy
service, port 53 TCP, resolv.conf, and NTP daemon.

Co-Authored-By: Claude <noreply@anthropic.com>

[tests] Add SSH and networking test cases.

Test SSH daemon (service, port 72, authorized_keys, key
auth shell command) and networking (service, eth0).

Co-Authored-By: Claude <noreply@anthropic.com>

[tests] Add home environment and package
test cases.

Test claude-code and paseo binaries, dak user existence,
and home activation via dotfile (.guile).

Co-Authored-By: Claude <noreply@anthropic.com>

[tests] Add VPS test harness infrastructure.

Boot a marionette VM that inherits from vps-operating-system
with static networking and a throwaway SSH key.  No
individual test cases yet — the harness validates that the
VM boots and the marionette REPL is reachable.  Add
test-vps / test-vps-fresh Makefile targets with cache.

Co-Authored-By: Claude <noreply@anthropic.com>

[vps] Module-ify vps-system and vps-home;
update Makefile targets.

Convert vps-system.scm and vps-home.scm from plain Guile
scripts to proper modules with #:export.  Update Makefile
build targets to use -L and -e syntax.  Set dak shell to
bash and add sudoers entry.

Co-Authored-By: Claude <noreply@anthropic.com>

[vps] Extract sshd configuration into conf/vps/sshd.scm.

Move the inline openssh-configuration out of vps-system.scm into a
dedicated module.  Update settings to match the reference sshd_config:
port 72, disable password auth, tune keepalive timeouts, and accept
locale environment variables.  Only override fields that differ from
the Guix defaults.

Co-Authored-By: Claude <noreply@anthropic.com>

[paseo] Use custom wrapper with CLAUDE_CONFIG_DIR pointing to claude-code store path.

[home] Install paseo package directly.

Add paseo to the packages list and drop the service wrapper.

Co-Authored-By: Claude <noreply@anthropic.com>

[vps] Install paseo and Claude Code in vps-home.scm.

Add imports for (conf home paseo) and (conf home claude), a packages
field with claude-code, and paseo-service plus paseo-daemon-service
to the VPS home configuration.

Co-Authored-By: Claude <noreply@anthropic.com>

[vps] Add VPS system and home configurations.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Bundle Claude Code configuration into the package.

Co-Authored-By: Claude <noreply@anthropic.com>

[ai] Remove resolved merge-conflict TODO, add SetCwd TODO.

The TODO was addressed by f8a4bd0 which added Enter
enforcement and a PreToolUse hook for automatic isolation.

Add a TODO to adopt SetCwd after
https://github.com/anthropics/claude-code/issues/69159 is resolved.

[home] Note that pi 0.80.5 still has the Bun --compile issue

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Move TODOs from README to dedicated TODO file.

Add TODO to remove CLAUDE_CONFIG_DIR from the paseo Shepherd service
and set it generically for all daemons that spawn Claude Code.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] TODO: API key injection for Paseo mobile-to-laptop relay

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Simplify and clarify npm-install-build-system

Rename functions for clarity, drop coreutils dependency, merge
helpers into the build system as an inline lambda. Reduce four
top-level definitions to two.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Extract claude-code package to its own module.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Add TODO to move config files to the Guix store.

Co-Authored-By: Claude <noreply@anthropic.com>

[style] Separate then from if in shell scripts.

Move 'then' to its own line after 'if' for readability. Also
converts the remaining extended regex patterns in guix-check to basic
regex, and fixes a comment case in notify.

[home] Add paseo CLI package and services.

The paseo daemon spawns Claude Code agents, so CLAUDE_CONFIG_DIR is
set in the daemon environment to point to ~/.config/claude/, where the
home claude service installs its configuration. This ensures spawned
agents find their config without relying on shell init files.

[home] Add pi coding agent package.

[ai] Add commit policy and hook-sharing guidelines.

[ai] Set baseRef to head.

[home] Add npm-install-build-system.

[ai] Replace guard-commands with block-builds, block, and create hooks.

Splits the monolithic guard-commands hook into three single-purpose
hooks with more granular matchers in settings.json.

block-builds:
Guards guix and make build/reconfigure commands. Asks on main,
denies in for destructive operations (reconfigure,
home-*, system-*).

block:
Denies git checkout/switch outright. Enforces Enter
(must not already be in a ) and Exit (must not
have unpushed commits diverging from main). Sends a desktop
notification on Enter success.

create:
Uses a universal matcher ("*") to deny all tool calls on main
unless already inside the session's . Allows
Enter through to let the user enter an isolated session.

[ai] Move ask-build-queue from hooks/ to scripts/.

Relocates the build-queue dialog from the hooks directory to the
scripts directory, reflecting its role as a manually-invoked helper
rather than an automatic hook. Also adds branch-awareness: the
script now asks about builds on non-main branches and reconfigures
on main.

[ai] Add merge workflow: branch-summary, merge script, and skill doc.

[ai] Add status-line hook showing session in prompt.

Displays the current session ID or branch name in the
Claude Code status line, making it visible at a glance whether
the session is running in an isolated or on main.

[ai] Extract build-queue dialog to standalone ask-build-queue script.

Move the AskUserQuestion dialog out of the guix-build Stop hook into
a separate script so it can be invoked proactively (before code changes
begin) rather than only at Stop time.

- ask-build-queue: new script with the build-target selection dialog.
  Exits early if a queue file already exists for the session.
- guix-build: simplified to use $CLAUDE_CODE_SESSION_ID directly
  instead of JSON parsing.  Delegates the no-queue case to
  ask-build-queue.
- CLAUDE.md: instructs to run ask-build-queue before any prompt that
  looks like it will modify code.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Use guix repl as the Geiser Guile REPL backend.

Set geiser-guile-binary to ("guix" "repl") so the Geiser REPL
starts inside the Guix execution environment, giving it access to all
Guix-installed Guile libraries.

[ai] Add guix-build stop hook, guard-commands hook, and Makefile build targets

guard-commands guards against dangerous or branch-inappropriate
commands: guix reconfigure (denied on branches), guix build
(ask everywhere), make reconfigure targets (denied on
branches), git checkout/switch (denied everywhere).

Makefile gains build-home-nonfree, build-home-libre,
build-system-nonfree, and build-system-libre targets for
the build queue.

[system] Add passwordless sudo for guix system reconfigure.

Allow AI agents to build the system without asking for password.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Install system-wide CLAUDE.md via Guix home as a dotfile.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Add desktop notification hooks for Claude Code.

Send dunstify notifications on permission_prompt and idle_prompt
events via a shell script alongside the existing guix-check hook.
Uses a single Notification matcher entry in project settings.json
referenced via CLAUDE_PROJECT_DIR.

Co-Authored-By: Claude <noreply@anthropic.com>

[home] Introduce Claude Code settings.json installed via Guix home.

- Add claude/.config/claude/settings.json with model overrides, max
- effort and apiKeyHelper wired to pass.
- Add conf/home/claude.scm service module bundling the claude-code
  package with its dotfile.
- Wire claude-service into home.scm, replacing the raw claude-code
  package.

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

[emacs] Add geiser-guile and flymake-guile for Scheme editing.

Configure geiser-guile and flymake-guile in conf-lisp.el, gated on the
guile binary being present for portability.  Document the Lisp/Scheme
ecosystem and the environment variables set in .dir-locals.el.

Update .dir-locals.el copyright year to 2026.

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

[home] Fix duplicate service type conflict in home reconfigure.

home-symlink-service-type was named 'home-profile', colliding with
the built-in home-profile-service-type.  Additionally, both
profile-service (bash.scm) and channels-service (guix.scm) directly
instantiated home-symlink-service-type — but Guix allows only one
direct (service <type> ...) per service type across the entire service
graph.

Changes:
- symlink.scm: Rename service type from 'home-profile' to
  'home-symlink', reflecting its actual purpose.
- bash.scm: Route profile-service through home-program-service-type
  (which extends home-symlink-service-type via service-extension)
  instead of directly instantiating it.  Remove unused
  (conf home symlink) import.
- guix.scm: Same for channels-service.  Switch import from
  (conf home symlink) to (conf home program).

Service extensions can be merged by Guix; direct instantiations
cannot, hence the "more than one target service" error.

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

[home] Install Claude Code.

Introduce a Guix package for the upstream Claude Code binary.  The
binary is prebuilt for FHS systems, so wrap it in a shell script that
sets LD_LIBRARY_PATH to Guix store paths and invokes it via ld-linux.

Set CLAUDE_CONFIG_DIR to store its configuration under ~/.config/claude
instead of ~/.claude.  Document manual version-update instructions in
the README.

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

[emacs] Set Guile environment variables in dir-locals.

.dir-locals.el now sets GUILE_LOAD_PATH and GUILE_LOAD_COMPILED_PATH
so that Emacs can compile Guile files with guild compile. TAGS file is
no longer necessary as geiser provides references.

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

Run guix style and remove unused code.

[home][system] Introduce a nonfree configuration.

Pull nonguix guix channel. Select configuration through $PROFILE.

[ai] Add a Claude Code hook to format and compile guile files.

[ai] Initialize CLAUDE.md.

[emacs] Upgrade built-in transient package.

[home] Install emacs-org-roam through emacs.

[system] Enable DNS over TLS.

[system] Configure custom DNS.

[emacs] Pull RSS feed from a RSS server.

[system] Install Noto Emoji from a separate package.

[system] Install nss-certs from %base-packages instead of specifying it explicitly.

[system] Explicly disable Wayland.

Accordion to documentation, `(wayland? #f)` is the default
setting. However, Guix installed Xwayland which broke the
system. By disabling Wayland explicitly Guix returned to Xorg.

[system] Format system.scm.

[system] Import golang dependencies from `(gnu packages golang-build)`.

[system] Format dns.scm.

[home] Install `pinentry`.

[home] Format emacs.scm.

Update copyright year for 2024.

[home] Import `dunst` from `(gnu packages wm)`.

[emacs] Append date when inserting calendar event.

If the date is not present, org-gcal appends it. However, it requires
full date+time timestamp specification which is not always
appropriate.

[emacs] Format conf-calendar.el.

[emacs] Do not archive calendar entries.

[emacs] Do not append Message-Id to emails.

Specify full log-file path.

XDG_LOG_HOME is no longer available when shephard starts.

[emacs] Install binutils as a dependency for gcal.

[suckless] Update commits after switching branches to main.

[emacs] Fix use-package failing to load packages.

[emacs] Use org-roam from installed externally.

Uninstall stow.

Install icecat-minimal.

[emacs] Connect calfw to Google Calendar API.

[emacs] Install `notmuch` extensions.

[emacs] Use `mbsync` from `PATH`.

[emacs] Initialize environment variable for `notmuch`.

[notmuch] Add refresh script.

[emacs] Prefer emacs package manager to guix.

Emacs package versions are more up to date.

[emacs] Switch from mpv to mplayer as the music backend.

mpv stopped working.

Update copyright year.

[home] Suspend the machine with `loginctl`.

[system] Lock the screen with `xsecurelock`.

`xsecurelock` must be added to `setuid-programs`. See documentation
for more information.

[system] Use polish keyboard layout in Xorg.

[home] Select emoji with dmenu.

[system] Install pulseaudio.

[home] Install flameshot.

[font] Use Meslo LG and Noto Color Emoji.

[st] Configure with Xresources.

[bash] Set st as the default terminal.

[system] Install custom versions of dwm and dmenu.

The source code is obtained from a self-hosted git instance.

[common] Package the Meslo LG font.

[home] Install custom st.

This commit installs custom version of the st terminal. It includes
the libxft-bgra patche and more. The source code is obtained from a
self-hosted git instance.

[system] Uninstall gnome.

[system] Enable bluetooth.

This commit install bluez as the bluetooth daemon.

[system] Encrypt DNS traffic.

Redirect DNS requests through `dnscrypt-proxy`, which encrypts the
traffic.

[system] Package a script for controlling volume level.

[home] Install a symlink manager.